From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/urlsearchparams/append/index.html | 78 ++++++++++++ files/ja/web/api/urlsearchparams/delete/index.html | 66 ++++++++++ .../ja/web/api/urlsearchparams/entries/index.html | 78 ++++++++++++ .../ja/web/api/urlsearchparams/foreach/index.html | 80 ++++++++++++ files/ja/web/api/urlsearchparams/get/index.html | 71 +++++++++++ files/ja/web/api/urlsearchparams/getall/index.html | 69 +++++++++++ files/ja/web/api/urlsearchparams/has/index.html | 66 ++++++++++ files/ja/web/api/urlsearchparams/index.html | 134 +++++++++++++++++++++ files/ja/web/api/urlsearchparams/keys/index.html | 77 ++++++++++++ files/ja/web/api/urlsearchparams/set/index.html | 127 +++++++++++++++++++ files/ja/web/api/urlsearchparams/sort/index.html | 70 +++++++++++ .../ja/web/api/urlsearchparams/tostring/index.html | 84 +++++++++++++ .../api/urlsearchparams/urlsearchparams/index.html | 78 ++++++++++++ files/ja/web/api/urlsearchparams/values/index.html | 77 ++++++++++++ 14 files changed, 1155 insertions(+) create mode 100644 files/ja/web/api/urlsearchparams/append/index.html create mode 100644 files/ja/web/api/urlsearchparams/delete/index.html create mode 100644 files/ja/web/api/urlsearchparams/entries/index.html create mode 100644 files/ja/web/api/urlsearchparams/foreach/index.html create mode 100644 files/ja/web/api/urlsearchparams/get/index.html create mode 100644 files/ja/web/api/urlsearchparams/getall/index.html create mode 100644 files/ja/web/api/urlsearchparams/has/index.html create mode 100644 files/ja/web/api/urlsearchparams/index.html create mode 100644 files/ja/web/api/urlsearchparams/keys/index.html create mode 100644 files/ja/web/api/urlsearchparams/set/index.html create mode 100644 files/ja/web/api/urlsearchparams/sort/index.html create mode 100644 files/ja/web/api/urlsearchparams/tostring/index.html create mode 100644 files/ja/web/api/urlsearchparams/urlsearchparams/index.html create mode 100644 files/ja/web/api/urlsearchparams/values/index.html (limited to 'files/ja/web/api/urlsearchparams') diff --git a/files/ja/web/api/urlsearchparams/append/index.html b/files/ja/web/api/urlsearchparams/append/index.html new file mode 100644 index 0000000000..9c9b87d6a6 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/append/index.html @@ -0,0 +1,78 @@ +--- +title: URLSearchParams.append() +slug: Web/API/URLSearchParams/append +tags: + - API + - Append + - Method + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams/append +--- +

{{ApiRef("URL API")}}

+ +

{{domxref("URLSearchParams")}} インターフェイスの append() メソッドは、指定されたキー/値のペアを新しい検索パラメーターとして追加します。

+ +

下にある例に示すように、同じキーが複数回追加された場合、各値がパラメーター文字列に複数回現れます。

+ +

{{availableinworkers}}

+ +

構文

+ +
URLSearchParams.append(name, value)
+ +

パラメーター

+ +
+
name
+
追加するパラメーターの名前。
+
value 
+
追加するパラメーターの値。
+
+ +

戻り値

+ +

無効。

+ +

例

+ +
let url = new URL('https://example.com?foo=1&bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+// 2番目の foo パラメーターを追加します。
+params.append('foo', 4);
+// クエリー文字列は現在: 'foo=1&bar=2&foo=4'
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#dom-urlsearchparams-append', "append()")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.append")}}

+
+ +

関連項目

+ + diff --git a/files/ja/web/api/urlsearchparams/delete/index.html b/files/ja/web/api/urlsearchparams/delete/index.html new file mode 100644 index 0000000000..8ff4474f14 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/delete/index.html @@ -0,0 +1,66 @@ +--- +title: URLSearchParams.delete() +slug: Web/API/URLSearchParams/delete +tags: + - API + - Method + - URL API + - URLSearchParams + - delete +translation_of: Web/API/URLSearchParams/delete +--- +

{{ApiRef("URL API")}}

+ +

{{domxref("URLSearchParams")}} インターフェイスの delete() メソッドは、すべての検索パラメーターのリストから、指定された検索パラメーターとそれに関連するすべての値を削除します。

+ +

{{availableinworkers}}

+ +

構文

+ +
URLSearchParams.delete(name)
+ +

パラメーター

+ +
+
name
+
削除するパラメーターの名前。
+
+ +

戻り値

+ +

無効

+ +

例

+ +
let url = new URL('https://example.com?foo=1&bar=2&foo=3');
+let params = new URLSearchParams(url.search.slice(1));
+
+// foo パラメーターを削除します。
+params.delete('foo'); // クエリー文字列は現在: 'bar=2'
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#dom-urlsearchparams-delete', "delete()")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.delete")}}

+
diff --git a/files/ja/web/api/urlsearchparams/entries/index.html b/files/ja/web/api/urlsearchparams/entries/index.html new file mode 100644 index 0000000000..1832463233 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/entries/index.html @@ -0,0 +1,78 @@ +--- +title: URLSearchParams.entries() +slug: Web/API/URLSearchParams/entries +tags: + - API + - Entries + - Method + - Reference + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams/entries +--- +

{{APIRef("URL API")}}

+ +

{{domxref("URLSearchParams")}} インターフェイスの entries() メソッドは、このオブジェクトに含まれるすべてのキー/値のペアを反復処理できる {{jsxref("Iteration_protocols","iterator")}} を返します。 各ペアのキーと値は {{domxref("USVString")}} オブジェクトです。

+ +

{{availableinworkers}}

+ +

構文

+ +
searchParams.entries();
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

{{jsxref("Iteration_protocols","iterator")}} を返します。

+ +

例

+ +
// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("key1=value1&key2=value2");
+
+// キー/値のペアの表示
+for(var pair of searchParams.entries()) {
+   console.log(pair[0]+ ', '+ pair[1]);
+}
+
+ +

結果は次のとおりです。

+ +
key1, value1
+key2, value2
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#interface-urlsearchparams', "entries() (see \"iterable\")")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.entries")}}

+
+ +

関連項目

+ + diff --git a/files/ja/web/api/urlsearchparams/foreach/index.html b/files/ja/web/api/urlsearchparams/foreach/index.html new file mode 100644 index 0000000000..b80b184093 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/foreach/index.html @@ -0,0 +1,80 @@ +--- +title: URLSearchParams.forEach() +slug: Web/API/URLSearchParams/forEach +tags: + - API + - Method + - Reference + - URL API + - URLSearchParams + - forEach +translation_of: Web/API/URLSearchParams/forEach +--- +
{{APIRef("URL API")}}
+ +

{{domxref("URLSearchParams")}} インターフェイスの forEach() メソッドを使用すると、コールバック関数を介してこのオブジェクトに含まれるすべての値を反復処理できます。

+ +

{{availableinworkers}}

+ +

構文

+ +
searchParams.forEach(callback);
+ +

パラメーター

+ +
+
callback
+
各パラメーターに対して実行されるコールバック関数。 そのパラメーターとして提供されたパラメーター値を使用します。
+
+ +

戻り値

+ +

無効。

+ +

例

+ +
// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("key1=value1&key2=value2");
+
+// 値の記録
+searchParams.forEach(function(value, key) {
+  console.log(value, key);
+});
+ +

結果は次のとおりです。

+ +
value1 key1
+value2 key2
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#interface-urlsearchparams', "forEach() (see \"iterable\")")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.forEach")}}

+
+ +

関連項目

+ + diff --git a/files/ja/web/api/urlsearchparams/get/index.html b/files/ja/web/api/urlsearchparams/get/index.html new file mode 100644 index 0000000000..241c9cda19 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/get/index.html @@ -0,0 +1,71 @@ +--- +title: URLSearchParams.get() +slug: Web/API/URLSearchParams/get +tags: + - API + - Method + - URL API + - URLSearchParams + - get +translation_of: Web/API/URLSearchParams/get +--- +

{{ApiRef("URL API")}}

+ +

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

+ +

{{availableinworkers}}

+ +

構文

+ +
URLSearchParams.get(name)
+ +

パラメーター

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

戻り値

+ +

指定された検索パラメーターが見つかった場合、{{domxref("USVString")}}。 それ以外の場合、null。

+ +

例

+ +

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

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

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

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

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#dom-urlsearchparams-get', "get()")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.get")}}

+
diff --git a/files/ja/web/api/urlsearchparams/getall/index.html b/files/ja/web/api/urlsearchparams/getall/index.html new file mode 100644 index 0000000000..466b8ca295 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/getall/index.html @@ -0,0 +1,69 @@ +--- +title: URLSearchParams.getAll() +slug: Web/API/URLSearchParams/getAll +tags: + - API + - Method + - URL API + - URLSearchParams + - getAll +translation_of: Web/API/URLSearchParams/getAll +--- +

{{ApiRef("URL API")}}

+ +

{{domxref("URLSearchParams")}} インターフェイスの getAll() メソッドは、指定された検索パラメーターに関連付けられたすべての値を配列として返します。

+ +

{{availableinworkers}}

+ +

構文

+ +
URLSearchParams.getAll(name)
+ +

パラメーター

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

戻り値

+ +

{{domxref("USVString")}} の配列。

+ +

例

+ +
let url = new URL('https://example.com?foo=1&bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+// 2番目の foo パラメーターを追加します。
+params.append('foo', 4);
+
+console.log(params.getAll('foo')) // ["1","4"] を表示します。
+
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#dom-urlsearchparams-getall', "getAll()")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.getAll")}}

+
diff --git a/files/ja/web/api/urlsearchparams/has/index.html b/files/ja/web/api/urlsearchparams/has/index.html new file mode 100644 index 0000000000..1bb28c72e6 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/has/index.html @@ -0,0 +1,66 @@ +--- +title: URLSearchParams.has() +slug: Web/API/URLSearchParams/has +tags: + - API + - Method + - URL API + - URLSearchParams + - has +translation_of: Web/API/URLSearchParams/has +--- +

{{ApiRef("URL API")}}

+ +

{{domxref("URLSearchParams")}} インターフェイスの has() メソッドは、指定された名前のパラメーターが存在するかどうかを示す {{jsxref("Boolean")}} を返します。

+ +

{{availableinworkers}}

+ +

構文

+ +
var hasName = URLSearchParams.has(name)
+ +

パラメーター

+ +
+
name
+
検索するパラメーターの名前。
+
+ +

戻り値

+ +

{{jsxref("Boolean")}}。

+ +

例

+ +
let url = new URL('https://example.com?foo=1&bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+params.has('bar') === true; // true
+
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#dom-urlsearchparams-has', "has()")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.has")}}

+
diff --git a/files/ja/web/api/urlsearchparams/index.html b/files/ja/web/api/urlsearchparams/index.html new file mode 100644 index 0000000000..b3ac0acc55 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/index.html @@ -0,0 +1,134 @@ +--- +title: URLSearchParams +slug: Web/API/URLSearchParams +tags: + - API + - Interface + - Landing + - Reference + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams +--- +
{{ApiRef("URL API")}}
+ +

URLSearchParams インターフェイスは URL のクエリー文字列の操作に役立つメソッドを定義します。

+ +

URLSearchParams を実装するオブジェクトは 直接 {{jsxref("Statements/for...of", "for...of")}} で使うことができます。例えば次の 2行は等価です。

+ +
for (const [key, value] of mySearchParams) {}
+for (const [key, value] of mySearchParams.entries()) {}
+ +

{{availableinworkers}}

+ +

コンストラクター

+ +
+
{{domxref("URLSearchParams.URLSearchParams", 'URLSearchParams()')}}
+
URLSearchParams オブジェクトを返すコンストラクターです。
+
+ +

メソッド

+ +
+
{{domxref("URLSearchParams.append()")}}
+
指定されたキーと値のペアを新しい検索パラメーターとして追加します。
+
{{domxref("URLSearchParams.delete()")}}
+
指定された検索パラメーターとその値を、検索パラメーターのリストからすべて削除します。
+
{{domxref("URLSearchParams.entries()")}}
+
このオブジェクトに含まれるすべてのキーと値のペアを列挙するための {{jsxref("Iteration_protocols","iterator")}} を返します。
+
{{domxref("URLSearchParams.forEach()")}}
+
コールバック関数を介して、このオブジェクトに含まれるすべての値を列挙します。
+
{{domxref("URLSearchParams.get()")}}
+
指定された検索パラメーターに対応する最初の値を返します。
+
{{domxref("URLSearchParams.getAll()")}}
+
指定された検索パラメーターに対応するすべての値を返します。
+
{{domxref("URLSearchParams.has()")}}
+
指定された検索パラメーターが存在するかを表す {{jsxref("Boolean")}} 値を返します。
+
{{domxref("URLSearchParams.keys()")}}
+
このオブジェクトに含まれるすべてのキーと値のペアのキーを列挙する {{jsxref("Iteration_protocols", "iterator")}} を返します。
+
{{domxref("URLSearchParams.set()")}}
+
指定された検索パラメーターに対応する値を設定します。複数の値が存在していた場合、それらは削除されます。
+
{{domxref("URLSearchParams.sort()")}}
+
すべてのキーと値のペアを、キーを基準にソートします。
+
{{domxref("URLSearchParams.toString()")}}
+
URL で使用するのに適したクエリー文字列を返します。
+
{{domxref("URLSearchParams.values()")}}
+
このオブジェクトに含まれるすべてのキーと値のペアの値を列挙する {{jsxref("Iteration_protocols", "iterator")}} を返します。
+
+ +

例

+ +
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"
+
+ +

コラム

+ +

URLSearchParams コンストラクターは完全な URL をパースしません。ただし、先頭に ? が存在すれば、読み飛ばします。

+ +
var paramsString1 = "http://example.com/search?query=%40";
+var searchParams1 = new URLSearchParams(paramsString1);
+
+searchParams1.has("query"); // false
+searchParams1.has("http://example.com/search?query"); // true
+
+searchParams1.get("query"); // null
+searchParams1.get("http://example.com/search?query"); // "@" (equivalent to decodeURIComponent('%40'))
+
+var paramsString2 = "?query=value";
+var searchParams2 = new URLSearchParams(paramsString2);
+searchParams2.has("query"); // true
+
+var url = new URL("http://example.com/search?query=%40");
+var searchParams3 = new URLSearchParams(url.search);
+searchParams3.has("query") // true
+
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}}{{Spec2('URL')}}初回定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.URLSearchParams")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/urlsearchparams/keys/index.html b/files/ja/web/api/urlsearchparams/keys/index.html new file mode 100644 index 0000000000..5ae2f46165 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/keys/index.html @@ -0,0 +1,77 @@ +--- +title: URLSearchParams.keys() +slug: Web/API/URLSearchParams/keys +tags: + - API + - Method + - Reference + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams/keys +--- +

{{APIRef("URL API")}}

+ +

{{domxref("URLSearchParams")}} インターフェイスの keys() メソッドは、このオブジェクトに含まれるすべてのキーを反復処理できる {{jsxref("Iteration_protocols",'iterator')}} を返します。 キーは {{domxref("USVString")}} オブジェクトです。

+ +

{{availableinworkers}}

+ +

構文

+ +
searchParams.keys();
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

{{jsxref("Iteration_protocols","iterator")}} を返します。

+ +

例

+ +
// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("key1=value1&key2=value2");
+
+// キーの表示
+for(var key of searchParams.keys()) {
+  console.log(key);
+}
+
+ +

結果は次のとおりです。

+ +
key1
+key2
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#interface-urlsearchparams', "keys() (see \"iterable\")")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.keys")}}

+
+ +

関連項目

+ + diff --git a/files/ja/web/api/urlsearchparams/set/index.html b/files/ja/web/api/urlsearchparams/set/index.html new file mode 100644 index 0000000000..8cdeb25297 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/set/index.html @@ -0,0 +1,127 @@ +--- +title: URLSearchParams.set() +slug: Web/API/URLSearchParams/set +tags: + - API + - Method + - URL API + - URLSearchParams + - set +translation_of: Web/API/URLSearchParams/set +--- +

{{ApiRef("URL API")}}

+ +

{{domxref("URLSearchParams")}} インターフェイスの set() メソッドは、指定された検索パラメーターに関連付けられた値を指定された値に設定します。 一致する値が複数ある場合、このメソッドは他の値を削除します。 検索パラメーターが存在しない場合、このメソッドはそれを作成します。

+ +

{{availableinworkers}}

+ +

構文

+ +
URLSearchParams.set(name, value)
+ +

パラメーター

+ +
+
name
+
設定するパラメーターの名前。
+
value 
+
設定するパラメーターの値。
+
+ +

戻り値

+ +

無効。

+ +

例

+ +

次の簡単な例から始めましょう。

+ +
let url = new URL('https://example.com?foo=1&bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+// 3番目のパラメーターを追加します。
+params.set('baz', 3);
+
+ +

以下は、{{domxref("URL")}} を作成し、いくつかの検索パラメーターを設定する方法を示す実際の例です。

+ +

スクラッチパッドに例をコピーして貼り付けることができます。

+ + + +
'use strict'
+
+function genURL(rExp, aText, bDebug=false){
+	let theURL
+
+	theURL= new URL('https://regexr.com')
+	theURL.searchParams.set( 'expression', rExp.toString() )
+	theURL.searchParams.set( 'tool', 'replace' )
+	theURL.searchParams.set( 'input', '\u2911\u20dc' )// ⤑⃜
+	theURL.searchParams.set( 'text', aText.join('\n') )
+	if( bDebug ){
+		// キー/値のペアを表示
+		for(var pair of theURL.searchParams.entries()) {
+			console.debug(pair[0] + ' = \'' + pair[1] + '\'');
+		}
+		console.debug(theURL)
+	}
+	return theURL
+}
+var url = genURL(
+	/(^\s*\/\/|\s*[^:]\/\/).*\s*$|\s*\/\*(.|\n)+?\*\/\s*$/gm	// 単一行/複数行のコメント
+	// /(^\s*\/\/.*|\s*[^:]\/\/.*)/g								// 単一行のコメント
+	,[
+		"これらは動作します:",
+		"",
+		"// eslint-disable-next-line no-unused-vars",
+		"lockPref(	'keyword.URL',\t\t'https://duckduckgo.com/html/?q=!+'	)\t//      test",
+		"/*",
+		"	* bla bla    ",
+		"*/",
+		"",
+		"/* bla bla */",
+		"",
+		"// bla bla ",
+		"",
+		"これらは動作しません:",
+		"console.log(\"http://foo.co.uk/\")",
+		"var url = \"http://regexr.com/foo.html?q=bar\"",
+		"alert(\"https://mediatemple.net\")",
+	]
+	, true
+)
+console.info( url, url.toString() )
+// window.open( url, 'regex_site' )
+
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#dom-urlsearchparams-set', "set()")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.set")}}

+
diff --git a/files/ja/web/api/urlsearchparams/sort/index.html b/files/ja/web/api/urlsearchparams/sort/index.html new file mode 100644 index 0000000000..3dba042a84 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/sort/index.html @@ -0,0 +1,70 @@ +--- +title: URLSearchParams.sort() +slug: Web/API/URLSearchParams/sort +tags: + - API + - Method + - Reference + - URL API + - URLSearchParams + - sort +translation_of: Web/API/URLSearchParams/sort +--- +

{{APIRef("URL API")}}

+ +

URLSearchParams.sort() メソッドは、このオブジェクトに含まれるすべてのキー/値のペアをその場でソートし、undefined を返します。 ソート順は、キーの Unicode コードポイントに従っています。 このメソッドは、安定したソートアルゴリズムを使用します（つまり、等しいキーを持つキー/値のペア間の相対的な順序が保持されます）。

+ +

{{availableinworkers}}

+ +

構文

+ +
searchParams.sort();
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

undefined。

+ +

例

+ +
// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("c=4&a=2&b=3&a=1");
+
+// キー/値のペアのソート
+searchParams.sort();
+
+// ソートされたクエリー文字列の表示
+console.log(searchParams.toString());
+
+ +

結果は次のとおりです。

+ +
a=2&a=1&b=3&c=4
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#dom-urlsearchparams-sort','sort()')}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.sort")}}

+
diff --git a/files/ja/web/api/urlsearchparams/tostring/index.html b/files/ja/web/api/urlsearchparams/tostring/index.html new file mode 100644 index 0000000000..3c82f6c04c --- /dev/null +++ b/files/ja/web/api/urlsearchparams/tostring/index.html @@ -0,0 +1,84 @@ +--- +title: URLSearchParams.toString() +slug: Web/API/URLSearchParams/toString +tags: + - API + - Method + - URL API + - URLSearchParams + - toString +translation_of: Web/API/URLSearchParams/toString +--- +

{{ApiRef("URL API")}}

+ +

{{domxref("URLSearchParams")}} インターフェイスの toString() メソッドは、URL での使用に適したクエリー文字列を返します。

+ +
+

注: このメソッドは、疑問符のないクエリー文字列を返します。 これは、それを含む window.location.search とは異なります。

+
+ +

{{availableinworkers}}

+ +

構文

+ +
URLSearchParams.toString()
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

疑問符のない {{domxref("DOMString")}}。

+ +

例

+ +
let url = new URL('https://example.com?foo=1&bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+// 2番目の foo パラメーターの追加
+params.append('foo', 4);
+console.log(params.toString());
+// 'foo=1&bar=2&foo=4' を表示
+
+// メモ: params は直接作成することもできます
+let url = new URL('https://example.com?foo=1&bar=2');
+let params = url.searchParams;
+
+// または、さらに単純に
+let params = new URLSearchParams('foo=1&bar=2');
+
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#interface-urlsearchparams', "toString() (see \"stringifier\")")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.toString")}}

+
+ +

関連項目

+ + diff --git a/files/ja/web/api/urlsearchparams/urlsearchparams/index.html b/files/ja/web/api/urlsearchparams/urlsearchparams/index.html new file mode 100644 index 0000000000..d28e18c1e3 --- /dev/null +++ b/files/ja/web/api/urlsearchparams/urlsearchparams/index.html @@ -0,0 +1,78 @@ +--- +title: URLSearchParams() +slug: Web/API/URLSearchParams/URLSearchParams +tags: + - API + - Constructor + - Reference + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams/URLSearchParams +--- +

{{ApiRef("URL API")}}

+ +

URLSearchParams() コンストラクターは、新しい {{domxref("URLSearchParams")}} オブジェクトを作成して返します。 先頭の '?' 文字は無視されます。

+ +

{{availableinworkers}}

+ +

構文

+ +
var URLSearchParams = new URLSearchParams(init);
+ +

パラメーター

+ +
+
init {{optional_inline}}
+
{{domxref("USVString")}} のインスタンス、{{domxref("URLSearchParams")}} のインスタンス、{{domxref("USVString")}} のシーケンス、または {{domxref("USVString")}} を含むレコード。 URLSearchParams インスタンスの使用は推奨されないことに注意してください。 ブラウザーは単に init に USVString を使用するようになります。
+
+ +

戻り値

+ +

{{domxref("URLSearchParams")}} のインスタンス。

+ +

例

+ +

次の例は、URL 文字列から {{domxref("URLSearchParams")}} オブジェクトを作成する方法を示しています。

+ +
// 文字列リテラルを渡す
+var url = new URL('https://example.com?foo=1&bar=2');
+// window.location から取得
+var url2 = new URL(window.location);
+
+// url.search を介してパラメーターを取得し、コンストラクターに渡す
+var params = new URLSearchParams(url.search);
+var params2 = new URLSearchParams(url2.search);
+
+// シーケンスを渡す
+var params3 = new URLSearchParams([["foo", 1],["bar", 2]]);
+
+// レコードを渡す
+var params4 = new URLSearchParams({"foo" : 1 , "bar" : 2});
+
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#dom-urlsearchparams-urlsearchparams', "URLSearchParams()")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.URLSearchParams")}}

+
diff --git a/files/ja/web/api/urlsearchparams/values/index.html b/files/ja/web/api/urlsearchparams/values/index.html new file mode 100644 index 0000000000..dfb2a8be1f --- /dev/null +++ b/files/ja/web/api/urlsearchparams/values/index.html @@ -0,0 +1,77 @@ +--- +title: URLSearchParams.values() +slug: Web/API/URLSearchParams/values +tags: + - API + - Iterator + - Method + - Reference + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams/values +--- +
{{APIRef("URL API")}}
+ +

{{domxref("URLsearchParams")}} インターフェースの values() メソッドは、このオブジェクトに含まれるすべての値を反復処理できる {{jsxref("Iteration_protocols",'iterator')}} を返します。 値は {{domxref("USVString")}} オブジェクトです。

+ +

{{availableinworkers}}

+ +

構文

+ +
searchParams.values();
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

{{jsxref("Iteration_protocols","iterator")}} を返します。

+ +

例

+ +
// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("key1=value1&key2=value2");
+
+// 値の表示
+for(var value of searchParams.values()) {
+  console.log(value);
+}
+ +

結果は次のとおりです。

+ +
value1
+value2
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('URL', '#interface-urlsearchparams', "values() (see \"iterable\")")}}{{Spec2('URL')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.URLSearchParams.values")}}

+
+ +

関連項目

+ + -- cgit v1.2.3-54-g00ecf