initial commit

14 files changed, 1155 insertions, 0 deletions

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
+---
+<p>{{ApiRef("URL API")}}</p>
+
+<p><span class="seoSummary">{{domxref("URLSearchParams")}} インターフェイスの <strong><code>append()</code></strong> メソッドは、指定されたキー/値のペアを新しい検索パラメーターとして追加します。</span></p>
+
+<p>下にある例に示すように、同じキーが複数回追加された場合、各値がパラメーター文字列に複数回現れます。</p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">URLSearchParams.append(<em>name</em>, <em>value</em>)</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<dl>
+ <dt>name</dt>
+ <dd>追加するパラメーターの名前。</dd>
+ <dt>value </dt>
+ <dd>追加するパラメーターの値。</dd>
+</dl>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>無効。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js">let url = new URL('https://example.com?foo=1&amp;bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+// 2番目の foo パラメーターを追加します。
+params.append('foo', 4);
+// クエリー文字列は現在: 'foo=1&amp;bar=2&amp;foo=4'</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#dom-urlsearchparams-append', "append()")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.append")}}</p>
+</div>
+
+<h2 id="See_also" name="See_also">関連項目</h2>
+
+<ul>
+ <li>その他の URL 関連インターフェイス: {{domxref("URL")}}、{{domxref("HTMLHyperlinkElementUtils")}}。</li>
+ <li><a href="https://developers.google.com/web/updates/2016/01/urlsearchparams?hl=en">Google Developers: URLSearchParams を使用した簡単な URL 操作</a>（英語）</li>
+</ul>
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
+---
+<p>{{ApiRef("URL API")}}</p>
+
+<p><span class="seoSummary">{{domxref("URLSearchParams")}} インターフェイスの <strong><code>delete()</code></strong> メソッドは、すべての検索パラメーターのリストから、指定された検索パラメーターとそれに関連するすべての値を削除します。</span></p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">URLSearchParams.delete(<em>name</em>)</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<dl>
+ <dt>name</dt>
+ <dd>削除するパラメーターの名前。</dd>
+</dl>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>無効</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js">let url = new URL('https://example.com?foo=1&amp;bar=2&amp;foo=3');
+let params = new URLSearchParams(url.search.slice(1));
+
+// foo パラメーターを削除します。
+params.delete('foo'); // クエリー文字列は現在: 'bar=2'</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#dom-urlsearchparams-delete', "delete()")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.delete")}}</p>
+</div>
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
+---
+<p>{{APIRef("URL API")}}</p>
+
+<p><span class="seoSummary">{{domxref("URLSearchParams")}} インターフェイスの <strong><code>entries()</code></strong> メソッドは、このオブジェクトに含まれるすべてのキー/値のペアを反復処理できる {{jsxref("Iteration_protocols","iterator")}} を返します。 各ペアのキーと値は {{domxref("USVString")}} オブジェクトです。</span></p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">searchParams.entries();</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<p>なし。</p>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>{{jsxref("Iteration_protocols","iterator")}} を返します。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js;highlight:[5]">// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("key1=value1&amp;key2=value2");
+
+// キー/値のペアの表示
+for(var pair of searchParams.entries()) {
+   console.log(pair[0]+ ', '+ pair[1]);
+}
+</pre>
+
+<p>結果は次のとおりです。</p>
+
+<pre>key1, value1
+key2, value2</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#interface-urlsearchparams', "entries() (see \"iterable\")")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.entries")}}</p>
+</div>
+
+<h2 id="See_also" name="See_also">関連項目</h2>
+
+<ul>
+ <li>{{domxref("URL")}} インターフェイス。</li>
+</ul>
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
+---
+<div>{{APIRef("URL API")}}</div>
+
+<p><span class="seoSummary">{{domxref("URLSearchParams")}} インターフェイスの <strong><code>forEach()</code></strong> メソッドを使用すると、コールバック関数を介してこのオブジェクトに含まれるすべての値を反復処理できます。</span></p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">searchParams.forEach(callback);</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<dl>
+ <dt>callback</dt>
+ <dd>各パラメーターに対して実行されるコールバック関数。 そのパラメーターとして提供されたパラメーター値を使用します。</dd>
+</dl>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>無効。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js;highlight:[5]">// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("key1=value1&amp;key2=value2");
+
+// 値の記録
+searchParams.forEach(function(value, key) {
+  console.log(value, key);
+});</pre>
+
+<p>結果は次のとおりです。</p>
+
+<pre>value1 key1
+value2 key2</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#interface-urlsearchparams', "forEach() (see \"iterable\")")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.forEach")}}</p>
+</div>
+
+<h2 id="See_also" name="See_also">関連項目</h2>
+
+<ul>
+ <li>{{domxref("URL")}} インターフェイス。</li>
+</ul>
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
+---
+<p>{{ApiRef("URL API")}}</p>
+
+<p><span class="seoSummary">{{domxref("URLSearchParams")}} インターフェースの <strong><code>get()</code></strong> メソッドは、指定された検索パラメーターに関連付けられた最初の値を返します。</span></p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">URLSearchParams.get(<em>name</em>)</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<dl>
+ <dt>name</dt>
+ <dd>返すパラメーターの名前。</dd>
+</dl>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>指定された検索パラメーターが見つかった場合、{{domxref("USVString")}}。 それ以外の場合、<strong><code>null</code></strong>。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<p>ページの URL が <code>https://example.com/?name=Jonathan&amp;age=18</code> の場合、次を使用して 'name' および 'age' のパラメーターを解析できます。</p>
+
+<pre class="default prettyprint prettyprinted"><code>let params = new URLSearchParams(document.location.search.substring(1));
+let name = params.get("name")<span class="kwd">; // 文字列 "Jonathan" です。
+</span>let age = parseInt(params.get("age"), 10<span class="kwd">); // 数値 18 です。</span></code>
+</pre>
+
+<p>クエリー文字列に存在しないパラメーターを要求すると、<strong><code>null</code></strong> が返されます。</p>
+
+<pre><code>let address = params.get("address"); // null</code></pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#dom-urlsearchparams-get', "get()")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.get")}}</p>
+</div>
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
+---
+<p>{{ApiRef("URL API")}}</p>
+
+<p><span class="seoSummary">{{domxref("URLSearchParams")}} インターフェイスの <strong><code>getAll()</code></strong> メソッドは、指定された検索パラメーターに関連付けられたすべての値を配列として返します。</span></p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">URLSearchParams.getAll(<em>name</em>)</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<dl>
+ <dt>name</dt>
+ <dd> 返すパラメーターの名前。</dd>
+</dl>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>{{domxref("USVString")}} の配列。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js">let url = new URL('https://example.com?foo=1&amp;bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+// 2番目の foo パラメーターを追加します。
+params.append('foo', 4);
+
+console.log(params.getAll('foo')) // ["1","4"] を表示します。
+</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#dom-urlsearchparams-getall', "getAll()")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.getAll")}}</p>
+</div>
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
+---
+<p>{{ApiRef("URL API")}}</p>
+
+<p><span class="seoSummary">{{domxref("URLSearchParams")}} インターフェイスの <strong><code>has()</code></strong> メソッドは、指定された名前のパラメーターが存在するかどうかを示す {{jsxref("Boolean")}} を返します。</span></p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">var <em>hasName</em> = URLSearchParams.has(<em>name</em>)</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<dl>
+ <dt>name</dt>
+ <dd>検索するパラメーターの名前。</dd>
+</dl>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>{{jsxref("Boolean")}}。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js">let url = new URL('https://example.com?foo=1&amp;bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+params.has('bar') === true; // true
+</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#dom-urlsearchparams-has', "has()")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.has")}}</p>
+</div>
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
+---
+<div>{{ApiRef("URL API")}}</div>
+
+<p><strong><code>URLSearchParams</code></strong> インターフェイスは URL のクエリー文字列の操作に役立つメソッドを定義します。</p>
+
+<p><code>URLSearchParams</code> を実装するオブジェクトは 直接 {{jsxref("Statements/for...of", "for...of")}} で使うことができます。例えば次の 2行は等価です。</p>
+
+<pre class="brush: js">for (const [key, value] of mySearchParams) {}
+for (const [key, value] of mySearchParams.entries()) {}</pre>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Constructor" name="Constructor">コンストラクター</h2>
+
+<dl>
+ <dt>{{domxref("URLSearchParams.URLSearchParams", 'URLSearchParams()')}}</dt>
+ <dd><code>URLSearchParams</code> オブジェクトを返すコンストラクターです。</dd>
+</dl>
+
+<h2 id="Methods" name="Methods">メソッド</h2>
+
+<dl>
+ <dt>{{domxref("URLSearchParams.append()")}}</dt>
+ <dd>指定されたキーと値のペアを新しい検索パラメーターとして追加します。</dd>
+ <dt>{{domxref("URLSearchParams.delete()")}}</dt>
+ <dd>指定された検索パラメーターとその値を、検索パラメーターのリストからすべて削除します。</dd>
+ <dt>{{domxref("URLSearchParams.entries()")}}</dt>
+ <dd>このオブジェクトに含まれるすべてのキーと値のペアを列挙するための {{jsxref("Iteration_protocols","iterator")}} を返します。</dd>
+ <dt>{{domxref("URLSearchParams.forEach()")}}</dt>
+ <dd>コールバック関数を介して、このオブジェクトに含まれるすべての値を列挙します。</dd>
+ <dt>{{domxref("URLSearchParams.get()")}}</dt>
+ <dd>指定された検索パラメーターに対応する最初の値を返します。</dd>
+ <dt>{{domxref("URLSearchParams.getAll()")}}</dt>
+ <dd>指定された検索パラメーターに対応するすべての値を返します。</dd>
+ <dt>{{domxref("URLSearchParams.has()")}}</dt>
+ <dd>指定された検索パラメーターが存在するかを表す {{jsxref("Boolean")}} 値を返します。</dd>
+ <dt>{{domxref("URLSearchParams.keys()")}}</dt>
+ <dd>このオブジェクトに含まれるすべてのキーと値のペアの<strong>キー</strong>を列挙する {{jsxref("Iteration_protocols", "iterator")}} を返します。</dd>
+ <dt>{{domxref("URLSearchParams.set()")}}</dt>
+ <dd>指定された検索パラメーターに対応する値を設定します。複数の値が存在していた場合、それらは削除されます。</dd>
+ <dt>{{domxref("URLSearchParams.sort()")}}</dt>
+ <dd>すべてのキーと値のペアを、キーを基準にソートします。</dd>
+ <dt>{{domxref("URLSearchParams.toString()")}}</dt>
+ <dd>URL で使用するのに適したクエリー文字列を返します。</dd>
+ <dt>{{domxref("URLSearchParams.values()")}}</dt>
+ <dd>このオブジェクトに含まれるすべてのキーと値のペアの<strong>値</strong>を列挙する {{jsxref("Iteration_protocols", "iterator")}} を返します。</dd>
+</dl>
+
+<h2 id="Example" name="Example">例</h2>
+
+<pre class="brush: js">var paramsString = "q=URLUtils.searchParams&amp;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&amp;topic=api&amp;topic=webdev"
+searchParams.set("topic", "More webdev");
+searchParams.toString(); // "q=URLUtils.searchParams&amp;topic=More+webdev"
+searchParams.delete("topic");
+searchParams.toString(); // "q=URLUtils.searchParams"
+</pre>
+
+<h3 id="Gotchas" name="Gotchas">コラム</h3>
+
+<p><code>URLSearchParams</code> コンストラクターは完全な URL をパースしません。ただし、先頭に <code>?</code> が存在すれば、読み飛ばします。</p>
+
+<pre class="brush: js">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
+</pre>
+
+<h2 id="Specifications" name="Specifications">仕様書</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様書</th>
+   <th scope="col">状態</th>
+   <th scope="col">備考</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初回定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、<a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>
+
+<p>{{Compat("api.URLSearchParams")}}</p>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li>{{domxref("URL")}} インターフェイス。</li>
+ <li><a href="https://developers.google.com/web/updates/2016/01/urlsearchparams?hl=en">Google Developers: URLSearchParams を使用した簡単な URL 操作</a> (英語)</li>
+</ul>
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
+---
+<p>{{APIRef("URL API")}}</p>
+
+<p><span class="seoSummary">{{domxref("URLSearchParams")}} インターフェイスの <strong><code>keys()</code></strong> メソッドは、このオブジェクトに含まれるすべてのキーを反復処理できる {{jsxref("Iteration_protocols",'iterator')}} を返します。 キーは {{domxref("USVString")}} オブジェクトです。</span></p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">searchParams.keys();</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<p>なし。</p>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>{{jsxref("Iteration_protocols","iterator")}} を返します。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js;highlight:[5]">// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("key1=value1&amp;key2=value2");
+
+// キーの表示
+for(var key of searchParams.keys()) {
+  console.log(key);
+}
+</pre>
+
+<p>結果は次のとおりです。</p>
+
+<pre>key1
+key2</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#interface-urlsearchparams', "keys() (see \"iterable\")")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.keys")}}</p>
+</div>
+
+<h2 id="See_also" name="See_also">関連項目</h2>
+
+<ul>
+ <li>{{domxref("URL")}} インターフェイス。</li>
+</ul>
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
+---
+<p>{{ApiRef("URL API")}}</p>
+
+<p>{{domxref("URLSearchParams")}} インターフェイスの <strong><code>set()</code></strong> メソッドは、指定された検索パラメーターに関連付けられた値を指定された値に設定します。 一致する値が複数ある場合、このメソッドは他の値を削除します。 検索パラメーターが存在しない場合、このメソッドはそれを作成します。</p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">URLSearchParams.set(<em>name</em>, <em>value</em>)</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<dl>
+ <dt>name</dt>
+ <dd>設定するパラメーターの名前。</dd>
+ <dt>value </dt>
+ <dd>設定するパラメーターの値。</dd>
+</dl>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>無効。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<p>次の簡単な例から始めましょう。</p>
+
+<pre class="brush: js">let url = new URL('https://example.com?foo=1&amp;bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+// 3番目のパラメーターを追加します。
+params.set('baz', 3);
+</pre>
+
+<p>以下は、{{domxref("URL")}} を作成し、いくつかの検索パラメーターを設定する方法を示す実際の例です。</p>
+
+<p><a href="/ja/docs/Tools/Scratchpad">スクラッチパッド</a>に例をコピーして貼り付けることができます。</p>
+
+<ul>
+ <li>41行目：コンソールへの (debug による) 検索パラメーターのダンプを停止するにはコメントにします。</li>
+ <li>43行目：生成されたオブジェクトとその文字列表現をコンソールに (info で) ダンプします。</li>
+ <li>44行目：生成された URL で新しいウィンドウ/タブを自動的に開こうとします（コメントが解除されている場合）。</li>
+</ul>
+
+<pre class="brush: js;highlight:[41,43,44]" id="genurl">'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' )
+</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#dom-urlsearchparams-set', "set()")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.set")}}</p>
+</div>
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
+---
+<p>{{APIRef("URL API")}}</p>
+
+<p><span class="seoSummary"><strong><code>URLSearchParams.sort()</code></strong> メソッドは、このオブジェクトに含まれるすべてのキー/値のペアをその場でソートし、<code>undefined</code> を返します。 ソート順は、キーの Unicode コードポイントに従っています。 このメソッドは、安定したソートアルゴリズムを使用します（つまり、等しいキーを持つキー/値のペア間の相対的な順序が保持されます）。</span></p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">searchParams.sort();</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<p>なし。</p>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p><code>undefined</code>。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js;highlight:[5]">// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("c=4&amp;a=2&amp;b=3&amp;a=1");
+
+// キー/値のペアのソート
+searchParams.sort();
+
+// ソートされたクエリー文字列の表示
+console.log(searchParams.toString());
+</pre>
+
+<p>結果は次のとおりです。</p>
+
+<pre>a=2&amp;a=1&amp;b=3&amp;c=4</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <tbody>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+  <tr>
+   <td>{{SpecName('URL', '#dom-urlsearchparams-sort','sort()')}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.sort")}}</p>
+</div>
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
+---
+<p>{{ApiRef("URL API")}}</p>
+
+<p><span class="seoSummary">{{domxref("URLSearchParams")}} インターフェイスの <strong><code>toString()</code></strong> メソッドは、URL での使用に適したクエリー文字列を返します。</span></p>
+
+<div class="blockIndicator note">
+<p><strong>注</strong>: このメソッドは、疑問符のないクエリー文字列を返します。 これは、それを含む <code><a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLHyperlinkElementUtils/search">window.location.search</a></code> とは異なります。</p>
+</div>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">URLSearchParams.toString()</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<p>なし。</p>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>疑問符のない {{domxref("DOMString")}}。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js">let url = new URL('https://example.com?foo=1&amp;bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+// 2番目の foo パラメーターの追加
+params.append('foo', 4);
+console.log(params.toString());
+// 'foo=1&amp;bar=2&amp;foo=4' を表示
+
+// メモ: params は直接作成することもできます
+let url = new URL('https://example.com?foo=1&amp;bar=2');
+let params = url.searchParams;
+
+// または、さらに単純に
+let params = new URLSearchParams('foo=1&amp;bar=2');
+</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#interface-urlsearchparams', "toString() (see \"stringifier\")")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.toString")}}</p>
+</div>
+
+<h2 id="See_also" name="See_also">関連項目</h2>
+
+<ul>
+ <li>{{domxref("URL")}} インターフェイス。</li>
+ <li><a href="https://developers.google.com/web/updates/2016/01/urlsearchparams?hl=en">Google Developers: URLSearchParams を使用した簡単な URL 操作</a>（英語）</li>
+</ul>
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
+---
+<p>{{ApiRef("URL API")}}</p>
+
+<p><span class="seoSummary"><strong><code>URLSearchParams()</code></strong> コンストラクターは、新しい {{domxref("URLSearchParams")}} オブジェクトを作成して返します。 先頭の <code>'?'</code> 文字は無視されます。</span></p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">var <em>URLSearchParams</em> = new URLSearchParams(<em>init</em>);</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<dl>
+ <dt><em><code>init</code></em> {{optional_inline}}</dt>
+ <dd>{{domxref("USVString")}} のインスタンス、{{domxref("URLSearchParams")}} のインスタンス、{{domxref("USVString")}} のシーケンス、または {{domxref("USVString")}} を含むレコード。 <code>URLSearchParams</code> インスタンスの使用は推奨されないことに注意してください。 ブラウザーは単に <em><code>init</code></em> に <code>USVString</code> を使用するようになります。</dd>
+</dl>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>{{domxref("URLSearchParams")}} のインスタンス。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<p>次の例は、URL 文字列から {{domxref("URLSearchParams")}} オブジェクトを作成する方法を示しています。</p>
+
+<pre class="brush: js">// 文字列リテラルを渡す
+var url = new URL('https://example.com?foo=1&amp;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});
+</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#dom-urlsearchparams-urlsearchparams', "URLSearchParams()")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.URLSearchParams")}}</p>
+</div>
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
+---
+<div>{{APIRef("URL API")}}</div>
+
+<p>{{domxref("URLsearchParams")}} インターフェースの <strong><code>values()</code></strong> メソッドは、このオブジェクトに含まれるすべての値を反復処理できる {{jsxref("Iteration_protocols",'iterator')}} を返します。 値は {{domxref("USVString")}} オブジェクトです。</p>
+
+<p>{{availableinworkers}}</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox">searchParams.values();</pre>
+
+<h3 id="Parameters" name="Parameters">パラメーター</h3>
+
+<p>なし。</p>
+
+<h3 id="Return_value" name="Return_value">戻り値</h3>
+
+<p>{{jsxref("Iteration_protocols","iterator")}} を返します。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js;highlight:[5]">// テスト用の URLSearchParams オブジェクトの作成
+var searchParams = new URLSearchParams("key1=value1&amp;key2=value2");
+
+// 値の表示
+for(var value of searchParams.values()) {
+  console.log(value);
+}</pre>
+
+<p>結果は次のとおりです。</p>
+
+<pre>value1
+value2</pre>
+
+<h2 id="Specifications" name="Specifications">仕様</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様</th>
+   <th scope="col">状態</th>
+   <th scope="col">コメント</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('URL', '#interface-urlsearchparams', "values() (see \"iterable\")")}}</td>
+   <td>{{Spec2('URL')}}</td>
+   <td>初期定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>
+
+
+<p>{{Compat("api.URLSearchParams.values")}}</p>
+</div>
+
+<h2 id="See_also" name="See_also">関連項目</h2>
+
+<ul>
+ <li>{{domxref("URL")}} インターフェイス。</li>
+</ul>