Chrome DevTools 协议（CDP）

首先获取标签页的 WebSocket URL：切勿直接连接 ws://localhost:9222/devtools/browser。应请求 http://localhost:9222/json/list，并从活跃标签页中提取 webSocketDebuggerUrl。

使用前需启用对应域（Domain）：在调用任何 Runtime.evaluate 或 Page.navigate 命令前，必须先调用 Runtime.enable 和 Page.enable。

CDP 是异步的：发送下一条命令前，须等待上一条命令的响应。建议使用基于 Promise 的封装，并通过响应 ID 进行追踪。

高 DPI 屏幕截屏：在 Page.captureScreenshot 参数中添加 fromSurface: true 和 scale: 2，以适配 Retina 显示屏。

响应体需单独获取：Network.responseReceived 事件不包含响应体内容。应在响应完成之后，使用该响应的 requestId 调用 Network.getResponseBody 获取响应体。

Chrome 扩展清单文件（Manifest V3）

权限拆分：使用 permissions 声明 API 权限，使用 host_permissions 声明主机（URL）权限。切勿在 permissions 中使用 http://*/*。

服务工作线程（Service Worker）会终止：无法维持持久状态。请使用 chrome.storage.local 替代全局变量；使用 chrome.alarms 替代 setInterval。

内容脚本（Content Script）隔离：无法访问页面全局对象。如需在页面上下文中执行代码，请使用 chrome.scripting.executeScript 并传入 func；如需内容脚本与页面间通信，请使用 window.postMessage。

存储操作是异步的：chrome.storage.local.get() 返回的是 Promise 而非原始数据，务必使用 await；同时需妥善处理 QUOTA_EXCEEDED 错误。

上下文检测

准确识别 Chrome 浏览器（而非 Edge/Brave）：检查 window.chrome && navigator.vendor === "Google Inc."，并排除 Opera 和 Edge。

扩展上下文类型判断：

• chrome.runtime.id 存在 → 内容脚本（content script）
• chrome.runtime.getManifest 存在 → 弹出页（popup）、后台页（background）或选项页（options）
• chrome.loadTimes 存在但无 runtime 对象 → 普通 Chrome 网页

清单版本检测：将 chrome.runtime.getManifest() 包裹在 try-catch 中调用；Manifest V3 使用 chrome.action，V2 使用 chrome.browserAction。

性能调试

内存 API 的条件检查：访问 performance.memory.usedJSHeapSize 前，需先确认 'memory' in performance 为真。

使用性能标记（Performance Marks）：通过 performance.mark() 和 performance.measure() 实现子帧级计时；使用后应及时清除标记，防止内存泄漏。

布局抖动（Layout Thrashing）检测：使用 PerformanceObserver，监听类型设为 entryTypes: ['measure', 'paint', 'largest-contentful-paint']；对耗时超过 16.67ms 的条目进行标记。

网络调试

导航前拦截资源：应在调用 Page.navigate 之前 调用 Network.setBlockedURLs，而非之后。

请求拦截：使用 Network.setRequestInterception 并设置 requestStage: 'Request' 以实现细粒度控制；返回 errorReason: 'BlockedByClient' 即可阻断请求。

安全上下文

混合内容（Mixed Content）：HTTPS 页面不可加载 HTTP 资源。请比对 location.protocol 与资源 URL 的协议是否一致。

CORS 错误：跨域 fetch 抛出 TypeError 通常表示 CORS 问题。请在 DevTools 的 Network 标签页中查看具体错误详情。

需处于安全上下文：文件系统访问 API（File System Access API）、剪贴板 API（Clipboard API）等要求 window.isSecureContext === true，且操作需由用户手势触发。