讲师中心 微信公众号
AI工具推荐 视频效率加速

Chrome Extension 中在页面 JS 执行前注入全局变量的正确方式

阿明君_3608

阿明君_3608

发布时间:2026-01-05 17:18:09

|

877人浏览过

|

来源于php中文网

原创

Chrome Extension 中在页面 JS 执行前注入全局变量的正确方式

在 manifest v3 下,若需确保扩展设置的 `window` 变量早于网页自身脚本执行,应将 content script 配置为 `"world": "main"` 并设 `run_at: "document_start"`,使其直接运行在页面主上下文中,无需动态插入脚本。

在 Chrome 扩展开发中,一个常见但易被误解的需求是:在目标网页的 JavaScript 运行前,预先注入并初始化 window 上的全局变量(如 window.someVar = true)。传统做法(如通过 document.createElement('script') 动态注入外部 JS 文件)往往失败——因为该注入行为本身发生在 content script 执行之后,而 content script 默认运行在隔离世界(ISOLATED world),无法直接影响页面 JS 环境,且动态创建的 <script> 标签插入时机不可控,极易晚于页面内联脚本或模块加载。

✅ 正确解法(Chrome 111+ 支持):
利用 Manifest V3 新增的 "world": "MAIN" 声明式能力,让 content script 直接运行在页面主 JavaScript 上下文(即 window 所在的 MAIN world)中,并在 DOM 构建初期(document_start 阶段)立即执行:

manifest.json(精简配置):

{
  "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"
  }]
}

content.js(极简有效):

Aria2 Json Rpc
Aria2 Json Rpc

通过 JSON‑RPC 2.0 与 aria2 下载管理器交互,使用自然语言命令管理下载、查询状态并控制任务。适用于 aria2、下载管理或种子操作。

下载
console.log("CE: Global var set in MAIN world at document_start");
window.someVar = true;
window.__EXT_INITIALIZED__ = Date.now();

⚠️ 关键说明与注意事项:

  • ✅ run_at: "document_start" + "world": "MAIN" 是黄金组合:此时 DOM 尚未解析完成,但 window 对象已存在,网页 JS(包括 <script> 标签、<script type="module">、defer/async 脚本)均未执行,变量可被后续所有页面脚本读取;
  • ❌ 不再需要 web_accessible_resources、injected.js 或任何动态脚本注入逻辑——这些不仅冗余,还会引入竞态风险;
  • ⚠️ MAIN world 中*无法访问 `chrome.API**(如chrome.runtime.sendMessage,chrome.storage`)。若需扩展能力(如读取配置、发送消息),必须拆分为两个 content script:
    • 主脚本("world": "MAIN"):仅负责设置 window 变量;
    • 辅助脚本(默认 ISOLATED world,无 world 字段):调用 chrome API,并通过 window.dispatchEvent(new CustomEvent(...)) 与 MAIN world 通信(反之亦然);
  • ? 验证是否生效:在目标页面开发者工具控制台中执行 window.someVar,应立即返回 true;同时检查 Performance.now() 或 console.timeStamp() 可确认其早于网页首屏 JS 执行。

总结:Manifest V3 下实现“早于页面 JS 注入全局变量”的标准实践,已从“手动注入”演进为“声明式上下文切换”。合理使用 "world": "MAIN" 不仅更可靠、更简洁,也完全符合 Chrome 官方推荐的安全模型。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

1995

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2782

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

956

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3139

2025.09.10

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

2546

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4579

2023.11.06

Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

3347

2026.03.24

全局变量怎么定义
全局变量怎么定义

本专题整合了全局变量相关内容,阅读专题下面的文章了解更多详细内容。

3885

2025.09.18

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn