【Node.js24.x】Object::URLSearchParams()メソッドの使い方

URLSearchParamsメソッドは、URLのクエリ文字列を解析し、操作するための新しいURLSearchParamsオブジェクトを作成するコンストラクタとして機能するメソッドです。ウェブページのURLには、例えば?name=Alice&age=30のように、キーと値のペアで構成されるクエリパラメータが含まれることがあります。このメソッドによって生成されるURLSearchParamsオブジェクトは、このような複雑なクエリ文字列を、キーに基づいてパラメータを読み取ったり、新しいパラメータを追加したり、既存のパラメータの値を更新したり、不要なパラメータを削除したりといった、一連の操作を簡単に行えるようにします。

システムエンジニアを目指す初心者の方にとって、URLのクエリパラメータは、ユーザーからの入力情報やページの現在の状態を管理する上で頻繁に遭遇する要素です。従来、これらのパラメータを直接文字列として解析・操作するには、正規表現や文字列分割などの複雑な処理が必要でしたが、URLSearchParamsメソッドを用いることで、そのような手間を大幅に削減し、より直感的で安全な方法でパラメータを扱えるようになります。これにより、Webアプリケーションの開発において、データの受け渡しや状態管理の実装が効率的かつ堅牢に行えるようになります。

Copy
1const queryString = 'name=Alice&age=30';
2const urlParams = new URLSearchParams(queryString);
3const name = urlParams.get('name');
4const age = urlParams.get('age');

init

• init: URLSearchParams オブジェクトを初期化するための値。以下のいずれかの形式をとります。
  • string: クエリ文字列
  • URLSearchParams: 別の URLSearchParams オブジェクト
  • {[key: string]: string | string[]}: キーと値のペアのオブジェクト
  • Iterable<[string, string]>: キーと値のペアのイテラブル（例: Array of arrays）

URLSearchParams

URLSearchParams クラスのコンストラクターであり、新しい URLSearchParams オブジェクトを生成します。URL のクエリ文字列や、キーと値のペアの配列などから、URL のクエリパラメータを操作するためのオブジェクトを作成します。