delete

用于删除请求 URL、请求/响应头、请求/响应内容。

规则语法

pattern delete://prop1|prop2|... [filters...]

# 等效于：
pattern delete://prop1 delete://prop2 ... [filters...]

分隔符为 | 或 &

配置示例

https://www.example.com/path delete://reqCookies.token|resCookies.token

https://raw.githubusercontent.com/avwo/whistle/refs/heads/master/package.json delete://resBody.name resType://json

上述 cookie 删除操作仅作用于请求/响应过程中的 cookie，不会修改浏览器本地存储的 cookie。如需修改浏览器持久化 cookie，可通过以下方式实现：

• 通过 jsPrepend 等注入 JS 删除
• 通过 resCookies 设置 cookie 过期

删除路径

支持版本：v2.9.102 及以上

规则语法

# 基本格式
目标域名 delete://pathname.索引号

# 示例
www.example.com/api/path/to delete://pathname.0 delete://pathname.1 delete://pathname.-1

规则说明

该规则用于删除请求 URL 中路径的特定分段。Whistle 会提取不包含查询参数的请求路径，并通过 / 分割成数组后进行删除操作。

示例解析：

• 请求URL：https://www.example.com/api/path/to/xxx?query
• 提取路径：api/path/to/xxx
• 分割数组：['api', 'path', 'to', 'xxx']
• 应用规则：
  • delete://pathname.0 → 删除 'api'
  • delete://pathname.1 → 删除 'path'
  • delete://pathname.-1 → 删除 'xxx'
• 最终路径：/to
• 完整结果：https://www.example.com/to?query

索引规则

• 正数索引：从 0 开始，表示从前往后的顺序
• 负数索引：从 -1 开始，表示从后往前的位置（-1 = 最后一段，-2 = 倒数第二段，以此类推）
• 特殊值：使用 last 可删除最后一段路径但保留末尾斜杠
• 边界情况：超出数组范围的索引将被忽略

重要说明

当路径以 / 结尾时，分割后的数组最后会包含一个空字符串项：

• 路径：/api/path/to/xxx/
• 分割结果：['api', 'path', 'to', 'xxx', '']

使用建议

• 使用 pathname.-1 删除最后一段且不保留末尾斜杠
• 使用 pathname.last 删除最后一段但保留末尾斜杠

对比示例：

www.example.com/api/path/to delete://pathname.0 delete://pathname.1 delete://pathname.last

• 请求：https://www.example.com/api/path/to/xxx?query
• 结果：https://www.example.com/to/?query (保留末尾斜杠)

特殊字符

如果对象的 key 包含以下字符，在路径表达式中需要使用反斜杠 \ 进行转义：

• 分隔符：| 和 &
• 空格： （一个空格）
• 点：.
• 控制字符：制表符 \t、换行符 \n、回车符 \r、换页符 \f、垂直制表符 \v

转义规则

注意：反斜杠 \ 本身也是转义字符，若要表示字面反斜杠，需写作 \\。

示例

假设需要删除请求 body 中的两个 key：

• key1 为 \n .p（包含换行符、空格、点、字母 p）
• key2 为 test|&test（包含竖线和 &）

对应的路径表达式应写作：

reqBody.\n\ \.p.test\|\&test

其中：

• \n 表示换行符
• \ 表示空格
• \. 表示点
• \| 表示竖线
• \& 表示 & 符号

完整请求示例：

# 删除请求 body 中的 key1 和 key2
https://www.example.com/path delete://reqBody.\n\ \.p.test\|\&test