本文详解如何在 Manifest V3 下确保扩展脚本在网页自身 JS 运行前完成执行，通过 world: "MAIN" 配置直接在页面上下文中初始化 window 变量，彻底解决注入时机过晚问题。
本文详解如何在 manifest v3 下确保扩展脚本在网页自身 js 运行前完成执行，通过 `world: "main"` 配置直接在页面上下文中初始化 `window` 变量，彻底解决注入时机过晚问题。
在 Chrome 扩展开发中，若需向网页注入全局变量（如 window.someVar = true），并确保这些变量在目标网站的主 JavaScript 脚本执行前已就绪，传统“动态创建 <script> 标签注入外部 JS”的方式往往失效——因为即使 content script 设置了 "run_at": "document_start"，其注入的脚本仍运行在隔离的扩展上下文（ISOLATED world）中，且实际 DOM 插入与执行发生在 document_start 之后的微任务阶段，导致执行顺序变为：<strong>网站 JS → 注入脚本，违背预期。</script>
自 Chrome 111 起，Manifest V3 引入了 world: "MAIN" 声明式配置，使 content script 可直接在页面的主 JavaScript 上下文（即 MAIN world）中执行。这意味着脚本代码将与网页自身脚本共享同一个 window 对象和执行时序，真正实现「先于所有页面 JS」初始化全局状态。
✅ 正确实现方式（Manifest V3 + Chrome ≥111）
1. 简化 manifest.json，移除冗余配置
删除 web_accessible_resources 和外部 injected.js，仅保留 content script 并显式指定 world: "MAIN"：
{
"name": "script-injector",
"manifest_version": 3,
"version": "0.0.1",
"content_scripts": [{
"matches": ["*://localhost:*/*", "*://127.0.0.1:*/*"],
"js": ["content.js"],
"run_at": "document_start",
"world": "MAIN"
}]
}2. 直接在 content.js 中操作 window
无需 DOM 操作，所有赋值语句将同步生效于页面全局作用域：
// content.js
console.log("CE: MAIN-world script executed at document_start");
window.someVar = true;
window.API_CONFIG = { endpoint: "https://dev.example.com" };此时执行顺序严格满足要求：
✅ Content Script（MAIN world, document_start）→ ✅ 网站 JS（读取已存在的 window.someVar）
⚠️ 关键注意事项
-
chrome API 不可用：world: "MAIN" 下的脚本无法访问 chrome.runtime、chrome.storage 等扩展 API（会抛出 ReferenceError）。若需结合扩展能力（如读取配置、发送消息），应采用双 content script 架构：
- Script A（world: "MAIN"）：仅负责初始化 window 变量；
- Script B（默认 ISOLATED world）：调用 chrome.* API，并通过 CustomEvent 或 window.postMessage 与页面通信。
示例事件通信（Script B 发送）：
立即学习“Java免费学习笔记（深入）”；
// background or isolated content script window.dispatchEvent(new CustomEvent("EXT_INIT_COMPLETE", { detail: { config: { enabled: true } } }));页面内监听：
window.addEventListener("EXT_INIT_COMPLETE", e => { console.log("Extension config:", e.detail.config); }); -
兼容性兜底：若需支持 Chrome 注入方案，并配合 document.write()（不推荐）或 MutationObserver 监听
变化，但可靠性显著降低。 安全边界：MAIN world 脚本受网页 CSP 影响（如 script-src 'self' 可能阻止执行），建议在 matches 中精确限定受信环境（如本地开发地址），避免生产环境误用。
✅ 总结
"world": "MAIN" 是 Manifest V3 下实现「早于页面 JS 初始化全局变量」的官方、简洁、可靠的解决方案。它消除了手动注入的时序不确定性，将扩展逻辑无缝融入页面执行流。开发者只需确保 Chrome 版本 ≥111，移除冗余资源声明，并将初始化逻辑直写于 content.js 即可。对于需扩展 API 的复杂场景，配合 CustomEvent 跨 world 通信，即可兼顾功能完整性与执行时序准确性。
