このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

URLSearchParams: get() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年4月以降、すべてのブラウザーで利用可能です。

メモ: この機能はウェブワーカー内で利用可能です。

get()URLSearchParams インターフェイスのメソッドで、指定された検索パラメーターに関連付けられた最初の値を返します。

構文

js
get(name)

引数

name

返すパラメーターの名前。

返値

指定された検索パラメーターが見つかった場合は文字列です。それ以外の場合は null です。

ページの URL が https://example.com/?name=Jonathan&age=18 の場合、次のように 'name' および 'age' のパラメーターを解釈できます。

js
let params = new URLSearchParams(document.location.search);
let name = params.get("name"); // 文字列 "Jonathan" です
let age = parseInt(params.get("age"), 10); // 数値 18 です

クエリー文字列に存在しないパラメーターを要求すると、null が返されます。

js
let address = params.get("address"); // null

仕様書

仕様書
URL
# dom-urlsearchparams-get

ブラウザーの互換性