You need to enable JavaScript to run this app. 如何通过Chrome扩展捕获指定网站Cookie及修复chrome.cookies未定义报错
优惠活动
大模型
产品
解决方案
定价
更多

如何通过Chrome扩展捕获指定网站Cookie及修复chrome.cookies未定义报错

报错核心原因

你碰到的Uncaught TypeError: Cannot read property 'get' of undefined,本质是Manifest V3的架构规则和开发逻辑错配导致的:

  • Content script 运行在网页的隔离沙箱中,仅能和页面共享DOM,没有权限直接访问chrome.cookies这类需要扩展特权的API,就算在manifest里加了对应权限,content script的运行环境也不会注入这个API对象
  • 这类特权API只能在扩展的后台Service Worker线程中调用,和content script之间需要通过消息通道通信交互
分步修复方案

1. 修正manifest.json配置

原来的配置存在几个漏项,需要调整为如下结构:

  • 保留cookies权限声明,补充host_permissions配置——MV3架构下调用cookiesAPI必须获得对应目标域名的访问授权,仅声明cookies权限是不够的
  • 新增后台Service Worker的配置入口,所有特权API的逻辑都需要写在这个文件中
  • 修正content script的匹配规则:原配置的*://google.com/仅能匹配google.com根路径,覆盖不了带子域、带路径的访问场景,需要改为通配匹配规则

正确的manifest.json示例:

{
  "manifest_version": 3,
  "name": "Cookie捕获工具",
  "version": "1.0",
  "permissions": ["cookies"],
  "host_permissions": ["*://*.google.com/*"],
  "background": {
    "service_worker": "background.js"
  },
  "content_scripts": [
    {
      "matches": ["*://*.google.com/*"],
      "js": ["content.js"]
    }
  ]
}

2. 调整代码逻辑,打通跨环境通信

编写background.js(后台线程逻辑)

把原来写在content.js里的Cookie查询逻辑挪到后台,监听content script发来的查询请求,完成Cookie读取后把结果回传:

chrome.runtime.onMessage.addListener((request, sender, sendResponse) => {
  if (request.action === "getTargetCookie") {
    chrome.cookies.get(
      { url: request.targetUrl, name: request.cookieName },
      (cookie) => {
        sendResponse({ value: cookie ? cookie.value : null });
      }
    );
    // 必须返回true,标记当前消息通道需要等待异步响应,否则会提前断开连接
    return true;
  }
});

改写content.js

移除直接调用chrome.cookies的代码,改为向后台发送消息请求,等后台返回结果后再执行弹窗逻辑:

chrome.runtime.sendMessage(
  {
    action: "getTargetCookie",
    targetUrl: "https://google.com/",
    cookieName: "SSID"
  },
  (response) => {
    if (response.value) {
      alert(response.value);
    } else {
      alert("未获取到对应Cookie值");
    }
  }
);
常见踩坑提醒
  • Content script的运行环境仅开放了消息通信类的少量chrome接口,其他涉及隐私、权限的API(如cookies、本地存储、标签页操作)全部无法直接访问,必须放到Service Worker中执行
  • chrome.cookies.get传入的URL必须和目标Cookie的作用域完全匹配,否则会返回空值
  • 匹配规则如果没加路径通配符,会导致大部分目标页面下content script无法正常注入

内容的提问来源于stack exchange,提问作者Keven Augusto

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 20:06:02