From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../web/api/urlsearchparams/append/index.html | 114 ++++++++++++++++++ .../web/api/urlsearchparams/delete/index.html | 96 +++++++++++++++ .../web/api/urlsearchparams/entries/index.html | 57 +++++++++ .../web/api/urlsearchparams/foreach/index.html | 87 ++++++++++++++ files/zh-cn/web/api/urlsearchparams/get/index.html | 63 ++++++++++ .../web/api/urlsearchparams/getall/index.html | 68 +++++++++++ files/zh-cn/web/api/urlsearchparams/has/index.html | 58 +++++++++ files/zh-cn/web/api/urlsearchparams/index.html | 125 +++++++++++++++++++ .../zh-cn/web/api/urlsearchparams/keys/index.html | 57 +++++++++ files/zh-cn/web/api/urlsearchparams/set/index.html | 107 +++++++++++++++++ .../zh-cn/web/api/urlsearchparams/sort/index.html | 105 ++++++++++++++++ .../web/api/urlsearchparams/tostring/index.html | 106 ++++++++++++++++ .../api/urlsearchparams/urlsearchparams/index.html | 133 +++++++++++++++++++++ .../web/api/urlsearchparams/values/index.html | 57 +++++++++ 14 files changed, 1233 insertions(+) create mode 100644 files/zh-cn/web/api/urlsearchparams/append/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/delete/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/entries/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/foreach/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/get/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/getall/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/has/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/keys/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/set/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/sort/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/tostring/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/urlsearchparams/index.html create mode 100644 files/zh-cn/web/api/urlsearchparams/values/index.html (limited to 'files/zh-cn/web/api/urlsearchparams') diff --git a/files/zh-cn/web/api/urlsearchparams/append/index.html b/files/zh-cn/web/api/urlsearchparams/append/index.html new file mode 100644 index 0000000000..620c3ee5f3 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/append/index.html @@ -0,0 +1,114 @@ +--- +title: URLSearchParams.append() +slug: Web/API/URLSearchParams/append +translation_of: Web/API/URLSearchParams/append +--- +

{{ApiRef("URL API")}}{{SeeCompatTable}} 

+ +

append() 是 {{domxref("URLSearchParams")}} 接口的一个方法。可以插入一个新搜索参数。

+ +

语法

+ +
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));
+
+//添加第二个foo搜索参数。
+params.append('foo', 4);
+//查询字符串变成: 'foo=1&bar=2&foo=4'
+ +

说明

+ + + + + + + + + + + + + + + + +
说明现状说明
{{SpecName('URL', '#dom-urlsearchparams-append', "append()")}}{{Spec2('URL')}}初始定义
+ +

浏览器兼容性

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
基本支持{{CompatChrome(49.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
基本支持{{CompatNo}}{{CompatChrome(49.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatChrome(49.0)}}
+
+ +

参见

+ + diff --git a/files/zh-cn/web/api/urlsearchparams/delete/index.html b/files/zh-cn/web/api/urlsearchparams/delete/index.html new file mode 100644 index 0000000000..b6927e3e22 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/delete/index.html @@ -0,0 +1,96 @@ +--- +title: URLSearchParams.delete() +slug: Web/API/URLSearchParams/delete +translation_of: Web/API/URLSearchParams/delete +--- +

{{ApiRef("URL API")}}{{SeeCompatTable}} 

+ +

delete() 是 {{domxref("URLSearchParams")}} 接口的一个方法。可以删除指定名称的所有搜索参数。

+ +

语法

+ +
URLSearchParams.delete(name)
+ +

参数

+ +
+
name
+
需要删除的键值名称
+
+ +

返回

+ +

无

+ +

说明

+ + + + + + + + + + + + + + + + +
说明状态说明
{{SpecName('URL', '#dom-urlsearchparams-delete', "delete()")}}{{Spec2('URL')}}初始定义
+ +

浏览器兼容性

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
基本支持{{CompatChrome(49.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
基本支持{{CompatNo}}{{CompatChrome(49.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatChrome(49.0)}}
+
diff --git a/files/zh-cn/web/api/urlsearchparams/entries/index.html b/files/zh-cn/web/api/urlsearchparams/entries/index.html new file mode 100644 index 0000000000..23e87b1b59 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/entries/index.html @@ -0,0 +1,57 @@ +--- +title: URLSearchParams.entries() +slug: Web/API/URLSearchParams/entries +tags: + - API + - Experimental + - Method + - Reference + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams/entries +--- +

{{APIRef("URL API")}}{{SeeCompatTable}}

+ +

URLSearchParams.entries()方法返回一个{{jsxref("Iteration_protocols",'iterator')}}，允许遍历该对象中包含的所有键/值对。每一组键值对都是 {{domxref("USVString")}}对象

+ +
+

注意: 该方法在 Web Workers也是可用的.

+
+ +

语法

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

浏览器兼容性

+ +
+ + +

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

+
+ +

另请参阅

+ + diff --git a/files/zh-cn/web/api/urlsearchparams/foreach/index.html b/files/zh-cn/web/api/urlsearchparams/foreach/index.html new file mode 100644 index 0000000000..7ce04858eb --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/foreach/index.html @@ -0,0 +1,87 @@ +--- +title: URLSearchParams.forEach() +slug: Web/API/URLSearchParams/forEach +translation_of: Web/API/URLSearchParams/forEach +--- +
{{APIRef("URL API")}}
+ +
+ +

   URLSearchParams的实例对象上的方法forEach允许通过回调函数来遍历URLSearchParams实例对象上的键值对

+ +

{{availableinworkers}}

+ +

语法

+ +
searchParams.forEach(callback(value,key,searchParams));
+ +

参数

+ +
+
回调函数
+
    该回调函数可以接收到3个参数value,key,searchParams，我们可以在回调函数中对接收到的参数进行处理。而三个参数的含义如下：
+
    1.  value
+
     当前遍历到的键值
+
    2.  key
+
     当前遍历到的键名
+
    3.  searchParams
+
     当前调用forEach方法的实例对象
+
+ +

返回值

+ +

    空

+ +

例子

+ +
// 创建URLSearchParams对象的实例对象，用于测试
+var searchParams = new URLSearchParams("key1=value1&key2=value2");
+
+let returnValue = searchParams.forEach(function(value, key,searchParams) {
+     // 打印值
+     console.log(value, key,searchParams);
+});
+
+// 输出返回值
+console.log(returnValue)
+
+ +

结果是:

+ +
value1 key1 当前调用forEach方法的实例对象(也就是searchParams)
+value2 key2 当前调用forEach方法的实例对象(也就是searchParams)
+undefined  // 即没有返回值
+
+ +

Specifications

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('URL', '#interface-urlsearchparams', "forEach() (see \"iterable\")")}}{{Spec2('URL')}}Initial definition.
+ +

Browser compatibility

+ +
+ + +

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

+
+ +

See also

+ + diff --git a/files/zh-cn/web/api/urlsearchparams/get/index.html b/files/zh-cn/web/api/urlsearchparams/get/index.html new file mode 100644 index 0000000000..232b200c83 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/get/index.html @@ -0,0 +1,63 @@ +--- +title: URLSearchParams.get() +slug: Web/API/URLSearchParams/get +translation_of: Web/API/URLSearchParams/get +--- +

{{ApiRef("URL API")}}{{SeeCompatTable}} 

+ +

{{domxref("URLSearchParams")}} 接口的get()方法返回第一个与搜索参数对应的值。

+ +

语法

+ +
URLSearchParams.get(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"); // is the string "Jonathan"
+let age = parseInt(params.get("age"), 10); // is the number 18
+
+ +

查找一个不存在的键名则返回 null:

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

规范

+ + + + + + + + + + + + + + + + +
规范状态说明
{{SpecName('URL', '#dom-urlsearchparams-get', "get()")}}{{Spec2('URL')}}Initial definition.
+ +

浏览器兼容性

+ +
+ + +

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

+
diff --git a/files/zh-cn/web/api/urlsearchparams/getall/index.html b/files/zh-cn/web/api/urlsearchparams/getall/index.html new file mode 100644 index 0000000000..5fa3efdce2 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/getall/index.html @@ -0,0 +1,68 @@ +--- +title: URLSearchParams.getAll() +slug: Web/API/URLSearchParams/getAll +tags: + - API + - Experimental + - Method + - URL API + - URLSearchParams + - getAll +translation_of: Web/API/URLSearchParams/getAll +--- +

{{ApiRef("URL API")}}{{SeeCompatTable}} 

+ +

{{domxref("URLSearchParams")}}接口的getAll()方法，以数组的形式返回与指定搜索参数对应的所有值。

+ +

语法

+ +
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));
+
+//为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/zh-cn/web/api/urlsearchparams/has/index.html b/files/zh-cn/web/api/urlsearchparams/has/index.html new file mode 100644 index 0000000000..a4308386f1 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/has/index.html @@ -0,0 +1,58 @@ +--- +title: URLSearchParams.has() +slug: Web/API/URLSearchParams/has +translation_of: Web/API/URLSearchParams/has +--- +

{{ApiRef("URL API")}}{{SeeCompatTable}} 

+ +

{{domxref("URLSearchParams")}} 的has() 方法返回一个 {{jsxref("Boolean")}} 表示一个指定的键名对应的值是否存在。

+ +

语法

+ +
var hasName = URLSearchParams.has(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')}}Initial definition.
+ +

浏览器兼容性

+ +
+ + +

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

+
diff --git a/files/zh-cn/web/api/urlsearchparams/index.html b/files/zh-cn/web/api/urlsearchparams/index.html new file mode 100644 index 0000000000..0c21454e54 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/index.html @@ -0,0 +1,125 @@ +--- +title: URLSearchParams +slug: Web/API/URLSearchParams +tags: + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams +--- +

{{ApiRef("URL API")}}

+ +

URLSearchParams 接口定义了一些实用的方法来处理 URL 的查询字符串。

+ +

一个实现了 URLSearchParams 的对象可以直接用在 {{jsxref("Statements/for...of", "for...of")}} 结构中，例如下面两行是相等的：

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

Gotchas

+ +

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

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}}{{Spec2('URL')}}初次定义
+ +

浏览器兼容性

+ +

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

+ +

参见

+ + diff --git a/files/zh-cn/web/api/urlsearchparams/keys/index.html b/files/zh-cn/web/api/urlsearchparams/keys/index.html new file mode 100644 index 0000000000..2ff71529b3 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/keys/index.html @@ -0,0 +1,57 @@ +--- +title: URLSearchParams.keys() +slug: Web/API/URLSearchParams/keys +tags: + - API + - Experimental + - Method + - Reference + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams/keys +--- +

{{APIRef("URL API")}}{{SeeCompatTable}}

+ +

URLSearchParams.keys()返回一个{{jsxref("Iteration_protocols",'iterator')}}，遍历器允许遍历对象中包含的所有键。这些键都是{{domxref("USVString")}}对象。

+ +
+

注意: 该方法在 Web Workers中也可使用

+
+ +

语法

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

浏览器兼容性

+ +
+ + +

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

+
+ +

另请参考

+ + diff --git a/files/zh-cn/web/api/urlsearchparams/set/index.html b/files/zh-cn/web/api/urlsearchparams/set/index.html new file mode 100644 index 0000000000..6790f615e7 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/set/index.html @@ -0,0 +1,107 @@ +--- +title: URLSearchParams.set() +slug: Web/API/URLSearchParams/set +translation_of: Web/API/URLSearchParams/set +--- +

{{ApiRef("URL API")}}{{SeeCompatTable}} 

+ +

{{domxref("URLSearchParams")}}接口的set()方法用于设置和搜索参数相关联的值。如果设置前已经存在匹配的值，该方法会删除多余的，如果将要设置的值不存在，则创建它

+ +

语法

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

参数

+ +
+
键名
+
将要设置的参数的健值名。
+
参数值
+
所要设置的参数值。
+
+ +

返回值

+ +

Void

+ +

例子

+ +
let url = new URL('https://example.com?foo=1&bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+//Add a third parameter.
+params.set('baz', 3);
+
+ +

Specifications

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('URL', '#dom-urlsearchparams-set', "set()")}}{{Spec2('URL')}}Initial definition.
+ +

Browser compatibility

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatChrome(49.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{CompatNo}}{{CompatChrome(49.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatChrome(49.0)}}
+
diff --git a/files/zh-cn/web/api/urlsearchparams/sort/index.html b/files/zh-cn/web/api/urlsearchparams/sort/index.html new file mode 100644 index 0000000000..abe8fecd01 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/sort/index.html @@ -0,0 +1,105 @@ +--- +title: URLSearchParams.sort() +slug: Web/API/URLSearchParams/sort +translation_of: Web/API/URLSearchParams/sort +--- +

{{APIRef("URL API")}}{{SeeCompatTable}}

+ +

URLSearchParams.sort() 方法对包含在此对象中的所有键/值对进行排序，并返回undefined。排序顺序是根据键的Unicode代码点。该方法使用稳定的排序算法 (即，将保留具有相等键的键/值对之间的相对顺序)。

+ +

Syntax

+ +
searchParams.sort();
+ +

Return value

+ +

Returns undefined.

+ +

Example

+ +
// Create a test URLSearchParams object
+var searchParams = new URLSearchParams("c=4&a=2&b=3&a=1");
+
+// Sort the key/value pairs
+searchParams.sort();
+
+// Display the sorted query string
+console.log(searchParams.toString());
+
+ +

The result is:

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

Specifications

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('URL', '#urlsearchparams','sort() (as iterator<>)')}}{{Spec2('URL')}}Initial definition
+ +

Browser compatibility

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)Firefox OS (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
diff --git a/files/zh-cn/web/api/urlsearchparams/tostring/index.html b/files/zh-cn/web/api/urlsearchparams/tostring/index.html new file mode 100644 index 0000000000..6efd11d077 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/tostring/index.html @@ -0,0 +1,106 @@ +--- +title: URLSearchParams.toString() +slug: Web/API/URLSearchParams/toString +translation_of: Web/API/URLSearchParams/toString +--- +

{{ApiRef("URL API")}}{{SeeCompatTable}} 

+ +

{{domxref("URLSearchParams")}} 接口的toString()方法 返回适用在URL中的查询字符串。

+ +

语法

+ +
URLSearchParams.toString()
+ +

返回值

+ +

字符串

+ +

实例

+ +
let url = new URL('https://example.com?foo=1&bar=2');
+let params = new URLSearchParams(url.search.slice(1));
+
+//Add a second foo parameter.
+params.append('foo', 4);
+console.log(params.toString());
+//Prints 'foo=1&bar=2&foo=4'.
+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('URL', '#urlsearchparams-stringification-behavior', "toString()")}}{{Spec2('URL')}}Initial definition. Appears in the IDL as stringifier.
+ +

浏览器兼容

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatChrome(49.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{CompatNo}}{{CompatChrome(49.0)}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatChrome(49.0)}}
+
+ +

参考

+ + diff --git a/files/zh-cn/web/api/urlsearchparams/urlsearchparams/index.html b/files/zh-cn/web/api/urlsearchparams/urlsearchparams/index.html new file mode 100644 index 0000000000..7d4c0b206b --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/urlsearchparams/index.html @@ -0,0 +1,133 @@ +--- +title: URLSearchParams() +slug: Web/API/URLSearchParams/URLSearchParams +translation_of: Web/API/URLSearchParams/URLSearchParams +--- +

{{ApiRef("URL API")}}{{SeeCompatTable}}

+ +

URLSearchParams() 构造器创建并返回一个新的{{domxref("URLSearchParams")}} 对象。 开头的'?' 字符会被忽略。

+ +

语法

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

参数

+ +
+
init {{optional_inline}}
+
一个 {{domxref("USVString")}} 实例，一个 {{domxref("URLSearchParams")}} 实例，一个 {{domxref("USVString")}}，或者一个包含 {{domxref("USVString")}} 的记录。注意使用一个 URLSearchParams 实例作为参数已经被弃用了，以后的浏览器将会只使用一个 USVString 作为参数。
+
+ +

返回值

+ +

一个 {{domxref("URLSearchParams")}} 实例。

+ +

例子

+ +

下面的例子展示了用一个URL字符串创建一个 {{domxref("URLSearchParams")}} 对象。

+ +
// Pass in a string literal
+var url = new URL('https://example.com?foo=1&bar=2');
+// Retrieve from window.location
+var url2 = new URL(window.location);
+
+// Retrieve params via url.search, passed into ctor
+var params = new URLSearchParams(url.search);
+var params2 = new URLSearchParams(url2.search);
+
+// Pass in a sequence
+var params3 = new URLSearchParams([["foo", 1],["bar", 2]]);
+
+// Pass in a record
+var params4 = new URLSearchParams({"foo" : 1 , "bar" : 2});
+
+ +

浏览器兼容性

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatChrome(49.0)}}{{CompatGeckoDesktop("29.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
USVString or sequence for init object{{CompatVersionUnknown}}{{CompatGeckoDesktop("53")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
Record for init object{{CompatNo}}{{CompatGeckoDesktop("54")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{CompatNo}}{{CompatChrome(49.0)}}{{CompatGeckoMobile("29.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatChrome(49.0)}}
USVString  of sequence for init object{{CompatNo}}{{CompatVersionUnknown}}{{CompatGeckoMobile("53")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}
Record for init object{{CompatNo}}{{CompatVersionUnknown}}{{CompatGeckoMobile("54")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}
+
diff --git a/files/zh-cn/web/api/urlsearchparams/values/index.html b/files/zh-cn/web/api/urlsearchparams/values/index.html new file mode 100644 index 0000000000..a9e476bc83 --- /dev/null +++ b/files/zh-cn/web/api/urlsearchparams/values/index.html @@ -0,0 +1,57 @@ +--- +title: URLSearchParams.values() +slug: Web/API/URLSearchParams/values +tags: + - API + - Experimental + - Iterator + - Method + - Reference + - URL API + - URLSearchParams +translation_of: Web/API/URLSearchParams/values +--- +

{{APIRef("URL API")}}

+ +

URLSearchParams.values()方法返回一个{{jsxref("Iteration_protocols",'iterator')}}，该遍历器允许遍历对象中包含的所有值。这些值都是{{domxref("USVString")}}对象。

+ +
+

注意: 该方法在Web Workers中也可使用

+
+ +

语法

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

浏览器兼容性

+ +
+ + +

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

+
+ +

另请参考

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