速報

PHPの脆弱性を修正した11月19日の更新|FPMとセッションの影響条件

CATEGORY

【JavaScript】URLのクエリパラメータを取得する【URLSearchParams】

※本ページのリンクにはプロモーションが含まれています。

【JavaScript】URLのクエリパラメータを取得する【URLSearchParams】

目次

本記事では、JavaScriptでURLのクエリパラメータを取得する方法をご紹介しています。

URLのクエリパラメータを取得したいんだけど、どうすればいいのかな?

上記の疑問にお答えしています。

では、解説していきます。

スポンサーリンク

URLのクエリパラメータを取得する

URLオブジェクトでURLからクエリを取得し、URLSearchParamasオブジェクトでURLのクエリパラメータを取得します。

下記のURLからクエリパラメータを取得してみます。

https://into-the-program.com/?a=100&b=200&c=300

JS

const url = new URL('https://into-the-program.com?a=100&b=200&c=300');
const params = new URLSearchParams(url.search);

for(let param of params){ console.log(param); }

実行結果

["a", "100"]
["b", "200"]
["c", "300"]

URLSearchParamasはオブジェクトを返します。そのためfor...ofですべてのキーと値のペアを列挙することができます。

URLSearchParams.get()でキーを指定して値を取得する

前項ではクエリパラメータを取得してループですべてのキーと値のペアを出力しましたが、URLSearchParams.get()でキーを指定して値だけを取得することも可能です。URLSearchParams.get()は引数に指定した文字列と最初に一致するキーの値を返します。

JS

const url = new URL('https://into-the-program.com?a=100&b=200&c=300');
const params = new URLSearchParams(url.search);

console.log(params.get('a')); console.log(params.get('b')); console.log(params.get('c'));

実行結果

"100"
"200"
"300"

実行結果は想定した通りですね。指定したキーの値が出力されています。

スポンサーリンク

URLSearchParamsには他にも便利なメソッドが用意されている

本記事ではURLSearchParamsの一部メソッドした使用していないですが、他にも便利なメソッドが用意されています。

下記はURLSearchParamsのメソッド一覧です。クエリパラメータの処理であればURLSearchParamsさえあれば対応できるかと思います。

URLSearchParamsのメソッド一覧

URLSearchParams.append(key, value) 引数に指定されたキーと値を新しい検索パラメータとして追加する
URLSearchParams.delete(key) 指定されたキーと一致するすべてのキーとキーの値をパラメータから削除する
URLSearchParams.entries() オブジェクトに含まれるキーと値のペアを列挙するイテレータを返す
URLSearchParams.forEach() コールバック関数を介して、オブジェクトに含まれるすべての値を返す
URLSearchParams.get(key) 引数に指定されたキーと一致する最初のキーの値を返す
URLSearchParams.getAll(key) 引数に指定されたキーと一致するすべてのキーの値を返す
URLSearchParams.has(key) 引数に指定されたキーが存在するか真偽値(true|false)を返す
URLSearchParams.keys() オブジェクトに含まれるキーを列挙するイテレータを返す
URLSearchParams.set(key, value) 引数に指定されたキーと値をパラメータに設定する。同名の値が存在していた場合は削除される
URLSearchParams.sort() キーを基準にソートする
URLSearchParams.toString() クエリパラメータを返す
URLSearchParams.values() オブジェクトに含まれるキーの値を列挙するイテレータを返す

ただ、この便利なオブジェクト、IE11には対応していません。残念なことに。

しかしご安心を!

URLとURLSearchParamsにはポリフィルが用意されています。それを読み込むことで本記事でご紹介した内容であればIE11でも動作するようになります。

IE11の対応について

URLとURLSearchParamsのポリフィルに必要なJSのを記載しておきます。これらを<script>で読み込んでご利用ください。

URLのポリフィル

URLSearchParamasのポリフィル

これで上記のオブジェクトを使用できない悩みから解放されます!

スポンサーリンク

最後に

本記事でご紹介したURLとURLSearchParamsのオブジェクトの存在を知ったのはつい最近のことなのですが、クエリパラメータに関する処理であれば概ね対応できるほど充実した機能を提供してくれています。休み返上で勉強して良かったと思う瞬間です。今後もたくさん使っていきたいと思います!

以上、JavaScriptでURLのクエリパラメータを取得するURLSearchParamsのご紹介でした!

この記事を書いた人

Ryohei

Webエンジニア / アプリ開発者 / 技術ブログ運営者

福岡のWeb制作会社に勤務するWebエンジニアです。10年以上にわたりWeb制作・開発に携わり、ヒアリングや進行管理から、コーディング、CMSの構築、システム開発、サーバーの構築・保守・運用まで、Webサイト制作の工程を幅広く担当しています。Webサイトは、これまでに100以上の構築・保守を手がけてきました。

個人でもWebサイトの制作・改修やWebアプリの開発・運用を行い、AIを活用した開発にも取り組んでいます。近年はWebセキュリティにも注力しています。

2015年から技術メディア「Into the Program」を運営し、実務や開発で得た知識をもとに、プログラミングの実装方法やWebサイトの運用・セキュリティ情報を発信しています。

主な分野
Webサイト構築・保守・運用 / HTML/CSS / JavaScript / PHP / WordPress / サーバー構築・保守・運用 / アプリ開発 / セキュリティ対策
資格・試験合格
情報セキュリティマネジメント試験
基本情報技術者試験
AWS認定ソリューションアーキテクト アソシエイト
PHP8技術者認定ウィザード
メディア運営
2015年〜

記事の作成・更新について

セキュリティ記事は、ベンダーの公式アドバイザリやCVE・JVNなどの一次情報を参照し、出典と情報確認日を記載します。実環境での検証を行った場合は、その環境と確認範囲を明示します。重要な追加情報や誤りを把握した場合は、内容を確認して追記・訂正します。

関連する記事

おすすめの書籍

キーワードから探す

スポンサーリンク

CDN

世界各地のサーバーにWebサイトのファイルを複製して置き、利用者に近いサーバーから配信する仕組み。表示の高速化や負荷の分散に使う。

詳しく見る