この翻訳は不完全です。英語から この記事を翻訳 してください。

The URLSearchParams interface defines utility methods to work with the query string of a URL.

An object implementing URLSearchParams can directly be used in a for...of structure, instead of entries(): for (var p of mySearchParams) is equivalent to for (var p of mySearchParams.entries()).

コンストラクタ

URLSearchParams()
コンストラクタはURLSearchParamsオブジェクトを返します。

プロパティ

このインタフェースはプロパティを継承しません。

メソッド

このインタフェースはメソッドを継承しません。

URLSearchParams.append()
Appends a specified key/value pair as a new search parameter.
URLSearchParams.delete()
Deletes the given search parameter, and its associated value, from the list of all search parameters.
URLSearchParams.entries()
Returns an iterator allowing to go through all key/value pairs contained in this object.
URLSearchParams.get()
Returns the first value associated to the given search parameter.
URLSearchParams.getAll()
Returns all the values association with a given search parameter.
URLSearchParams.has()
Returns a Boolean indicating if such a search parameter exists.
URLSearchParams.keys()
Returns an iterator allowing to go through all keys of the key/value pairs contained in this object.
URLSearchParams.set()
Sets the value associated to a given search parameter to the given value. If there were several values, delete the others.
URLSearchParams.sort()
Sorts all key/value pairs, if any, by their keys.
URLSearchParams.toString()
Returns a string containing a query string suitable for use in a URL.
URLSearchParams.values()
Returns an iterator allowing to go through all values of the key/value pairs contained in this object.

使用例

var paramsString = "q=URLUtils.searchParams&topic=api"
var searchParams = new URLSearchParams(paramsString);

// 検索パラメータをループする。
for (let p of searchParams) {
  console.log(p);
}

searchParams.has("topic") === true; // true
searchParams.get("topic") === "api"; // true
searchParams.getAll("topic"); // ["api"]
searchParams.get("foo") === null; // true
searchParams.append("topic", "webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
searchParams.set("topic", "More webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
searchParams.delete("topic");
searchParams.toString(); // "q=URLUtils.searchParams"

仕様

仕様 策定状況 コメント
URL
URLSearchParams の定義
現行の標準 Initial definition.

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 49 29.0 (29.0) 未サポート 36 10.1
entries(), keys(), values(), and support of for...of 49 44.0 (44.0) 未サポート 36 ?
USVString for constructor init object (有) 53.0 (53.0) 未サポート (有) ?
Record for constructor init object 未サポート 54.0 (54.0) 未サポート ? ?
Feature Android Webview Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 49 49 29.0 (29.0) 未サポート ? 未サポート
entries(), keys(), values(), and support of for...of 49 49 44.0 (44.0) 未サポート ? 未サポート
USVString for constructor init object (有) (有) 53.0 (53.0) 未サポート ? ?
Record for constructor init object ? ? 54.0 (54.0) 未サポート ? ?

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: ShoheiTai
 最終更新者: ShoheiTai,