如何通过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
相关产品推荐
相关产品推荐

