大网数据广告活动
Web 标准与前端开发

URLSearchParams:delete() 方法

· 52CE 我爱测

URLSearchParams 接口的 **`delete()`** 方法从所有查询参数的列表中删除指定的参数及其关联值。

URL API

URLSearchParams 接口的 delete() 方法从所有查询参数的列表中删除指定的参数及其关联值。

一个参数名称和可选值用于匹配参数。如果指定了一个参数名称,则会删除所有与该名称匹配的查询参数及其关联值。如果同时指定了参数名称和值,则会删除所有与参数名称和数值匹配的查询参数。

语法

delete(name)
delete(name, value)

参数

  • name
    • : 需要删除的键值名称。
  • value
    • : 参数必须匹配的值以及要删除的给定名称。

返回值

无(undefined)。

示例

删除指定名称的所有参数

此示例显示如何删除具有特定名称的所有查询参数(和值)。

<pre id="log"></pre>
const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText += `${text}\n`;
}
const url = new URL("https://example.com?foo=1&bar=2&foo=3");
const params = new URLSearchParams(url.search);
log(`查询参数(删除前):${params}`);
params.delete("foo");
log(`查询参数(删除后):${params}`);

下面的日志显示所有名称为 foo 的参数都将被删除。

删除指定名称的所有参数

删除指定名称和值的所有参数

此示例显示如何删除具有特定的名称和值的查询参数。

<pre id="log"></pre>
const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText += `${text}\n`;
}
const url = new URL("https://example.com?foo=1&bar=2&foo=3&foo=1");
const params = new URLSearchParams(url.search);
log(`查询参数(删除前):${params}`);
params.delete("foo", "1");
log(`查询参数(删除后):${params}`);

所有与参数 name 和 value 匹配的参数应该被删除(没有理由指定两个具有相同名称和值的参数,如上所示)。

删除指定名称和值的所有参数

如果浏览器支持 value 选项,则“删除后”字符串应为 bar=2&foo=3。否则,结果将与前面的例子相同(bar=2)。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。