本文详解如何利用 Tampermonkey 的 GM_webRequest API 或 @webRequest 元指令，在 YouTube 等网站中精准拦截（如搜索建议）特定 GET 请求，避免无效的 fetch/XHR 替换方案。
本文详解如何利用 tampermonkey 的 `gm_webrequest` api 或 `@webrequest` 元指令，在 youtube 等网站中精准拦截（如搜索建议）特定 get 请求，避免无效的 fetch/xhr 替换方案。
在浏览器自动化与隐私优化场景中，单纯禁用前端功能（如清 Cookie、关设置）往往无法阻止 YouTube 搜索框触发的自动请求——例如向 https://suggestqueries-clients6.youtube.com/complete/search?... 发起的搜索建议请求。用户脚本若采用劫持 fetch 或重写 XMLHttpRequest.prototype.send 等方式，极易因执行时机过晚、请求已被框架封装或跨域策略限制而失效。
✅ 正确做法是使用 Tampermonkey 原生支持的网络层拦截机制：GM_webRequest（JavaScript API）或 @webRequest（声明式元指令）。二者均工作于浏览器网络栈底层，在请求发出前即完成匹配与阻断，具备高可靠性与低侵入性。
✅ 推荐方案一：使用 GM_webRequest（动态可控）
// ==UserScript==
// @name YouTube URL Blocker
// @namespace http://tampermonkey.net/
// @version 0.2
// @description 阻止 YouTube 搜索建议请求（底层拦截）
// @author me
// @match https://www.youtube.com/*
// @grant GM_webRequest
// ==/UserScript==
(function() {
'use strict';
// 支持通配符匹配：* 表示任意字符（含路径参数）
const blockedSelector = 'https://suggestqueries-clients6.youtube.com/complete/search*';
GM_webRequest([
{ selector: blockedSelector, action: 'cancel' }
], (info, message, details) => {
console.info('[YouTube Blocker] 已拦截搜索建议请求:', info.url);
});
})();⚠️ 注意事项：
- selector 必须为完整 URL 或含 * 的通配模式（如 https://example.com/api/*），不支持正则表达式；
- action: 'cancel' 会彻底终止请求，返回空响应（状态码 0，无网络错误提示）；
- 回调函数仅在请求被拦截时触发，可用于日志调试，但不影响拦截行为本身（即即使回调未定义，拦截仍生效）；
- 该 API 需显式声明 @grant GM_webRequest，且仅适用于 Chromium 内核浏览器（Chrome、Edge、Brave 等）及新版 Firefox（需启用 privacy.webRequest.allowHttpFiltering）。
✅ 推荐方案二：使用 @webRequest 元指令（启动即生效）
// ==UserScript==
// @name YouTube URL Blocker (Static)
// @namespace http://tampermonkey.net/
// @version 0.2
// @description 启动时立即拦截搜索建议请求（零延迟）
// @author me
// @match https://www.youtube.com/*
// @webRequest {"selector":"https://suggestqueries-clients6.youtube.com/complete/search*","action":"cancel"}
// ==/UserScript==
// 此处可留空，或添加其他 DOM 操作逻辑（如隐藏搜索建议面板）该方式优势在于：规则在用户脚本加载前即注册到浏览器网络监听器中，完全规避竞态问题，适合对时效性要求极高的拦截场景。其语法简洁，无需 JavaScript 执行上下文，但灵活性略低于 GM_webRequest（不支持运行时动态修改规则）。
❌ 为什么传统方法会失败？
- fetch 重写：YouTube 大量使用内部封装的请求工具（如 yt.networking），并非直接调用全局 fetch；
- XMLHttpRequest.prototype.send 劫持：现代框架常通过 new XMLHttpRequest() 实例化后直接调用 send()，但 _url 属性并不存在（需手动 patch open() 方法才能获取 URL），且部分请求由 Service Worker 或内置模块发起，绕过原型链；
- beforesendheaders 事件：该事件并非标准 Web API，Tampermonkey 不提供此事件，属常见误解。
✅ 最终验证建议
- 打开 YouTube → 点击搜索框 → 打开 DevTools → 切换至 Network 标签页；
- 在 Filter 中输入 suggestqueries，确认对应请求已消失（而非显示 cancelled 或报错）；
- 观察搜索建议下拉列表是否为空白或不再自动弹出——表明拦截成功。
综上，GM_webRequest 与 @webRequest 是当前 Tampermonkey 生态中拦截特定请求的唯一可靠方案。合理选用通配符、正确配置 @grant 或元指令，并结合 Network 面板验证，即可稳定实现隐私增强与性能优化目标。
