【JavaScript ECMAScript】Set::Set.prototype.isSupersetOfインスタンスメソッドの使い方
Set.prototype.isSupersetOf()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Set.prototype.isSupersetOf()メソッドは、あるSetオブジェクトが、別のSetオブジェクト（またはより一般的にはイテラブルオブジェクト）のすべての要素を含んでいるかどうかを判定するメソッドです。
このメソッドは、呼び出し元のSetが引数として渡されたSetの「スーパーセット」であるかどうかを調べます。スーパーセットとは、元のSetが対象のSetに含まれるすべての要素を、重複なく完全に持っている状態を指します。具体的には、引数として検証したいSet（または、Setに変換可能な要素を持つIterableオブジェクト）を渡します。もし呼び出し元のSetが、渡されたSetの全ての要素を包含していればtrueを返し、一つでも含まれていない要素があればfalseを返します。
この操作は元のSetの内容を変更することなく行われます。例えば、ある機能が要求する権限のSetと、ユーザーが実際に持っている権限のSetを比較し、ユーザーが必要なすべての権限を持っているかを確認する際など、集合間の包含関係を効率的にチェックしたい場合に非常に役立ちます。これにより、複雑な条件分岐を手動で記述することなく、簡潔に集合演算の結果を得ることができます。
公式リファレンス: Set.prototype.isSupersetOf()
構文(syntax)
1const setA = new Set([1, 2, 3]); 2const setB = new Set([1, 2]); 3setA.isSupersetOf(setB);
引数(parameters)
other
- other: Set: 照合する別のSetオブジェクト
戻り値(return)
boolean
指定されたSetオブジェクトが、もう一方のSetオブジェクトのすべての要素を含んでいる場合に true を、そうでない場合に false を返します。