【Node.js24.x】Set::values()メソッドの使い方
valuesメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
valuesメソッドは、呼び出されたSetオブジェクトに含まれるすべての要素を、挿入された順序で一つずつ取り出すための新しいイテレーターオブジェクトを返すメソッドです。
このメソッドを使用すると、Setに格納された重複のない一意な値を、for...ofループなどの構文を用いて順番に処理できます。Setは重複する値を保持しないので、valuesメソッドが提供するイテレーターも、各要素を必ず一度だけ返します。
Setオブジェクトでは、要素そのものがキーと値の両方の役割を担います。そのため、Set.prototype.keys()メソッドもvaluesメソッドと全く同じイテレーターオブジェクトを返します。これは、Setの要素がそのまま「値」として扱われる特性のためです。
valuesメソッドは、Set内の要素を順番に確認したい場合や、それらの要素を配列など別のデータ形式に変換したい場合に大変役立ちます。イテレーターは、Setの要素の追加や削除などの変更をリアルタイムで反映し、常に最新の要素セットに対して機能します。
構文(syntax)
1const mySet = new Set(['a', 1, true]); 2const valueIterator = mySet.values();
引数(parameters)
引数なし
引数はありません
戻り値(return)
SetIterator
Set オブジェクトに格納されている各要素を順に取得できるイテレーターを返します。このイテレーターを使用すると、Set の要素を一度に一つずつ取り出して処理できます。