此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

URLSearchParams:set() 方法

基线 广泛可用

自 2018年4月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

备注: 此特性在 Web Worker 中可用。

URLSearchParams 接口的 set() 方法用于设置和查询参数相关联的值。如果设置前已经存在多个匹配的值,此方法会删除重复的查询参数;如果查询参数不存在,则创建它。

语法

js
set(name, value)

参数

name

要设置的参数的键名。

value

要设置的参数的值。

返回值

无(undefined)。

示例

js
let url = new URL("https://example.com?foo=1&bar=2");
let params = new URLSearchParams(url.search);

// 设置第三个参数。
params.set("baz", 3);
params.toString(); // "foo=1&bar=2&baz=3"

规范

规范
URL
# dom-urlsearchparams-set

浏览器兼容性