如何使用 Tampermonkey 用户脚本拦截特定网络请求-js教程-PHP中文网

如何使用 Tampermonkey 用户脚本拦截特定网络请求

本文详解如何利用 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);
    });
})();

⚠️ 注意事项：

CoPaw
一款AI工具，主要用于通义实验室推出的个人智能体工作台，适合需要提升相关任务效率的用户。

下载

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 不提供此事件，属常见误解。