用JavaScript创建浏览器插件不难,核心是编写符合Manifest V3规范的manifest.json(含manifest_version、name、version等必填字段)、content.js、background.js和popup.html,并通过chrome://extensions加载调试。

用 JavaScript 创建浏览器插件不难,核心是写一个符合浏览器扩展规范的配置文件(manifest.json)和对应的脚本(如 content script、popup 页面或 background service worker),再加载到浏览器中调试。主流浏览器(Chrome、Edge、Firefox)都支持基于 Manifest V3 的扩展,以下以 Chrome 为例说明关键步骤。
准备 manifest.json 配置文件
这是每个插件的“身份证”,必须放在根目录,定义插件基本信息和权限。Manifest V3 要求使用 service_worker 替代旧版 background page。
- 必填字段包括:
manifest_version(设为 3)、name、version - 声明权限:比如读取当前网页需
"activeTab",操作标签页加"tabs",跨域请求要写明"host_permissions" - 指定入口:用
content_scripts注入 JS 到网页;用background.service_worker运行长期逻辑;用action配 popup HTML 页面
示例最小 manifest:
{
"manifest_version": 3,
"name": "我的小工具",
"version": "1.0",
"content_scripts": [{
"matches": [""],
"js": ["content.js"]
}],
"permissions": ["activeTab"],
"host_permissions": ["https://api.example.com/"],
"background": {
"service_worker": "background.js"
},
"action": {
"default_popup": "popup.html"
}
}
编写核心脚本(JavaScript)
不同脚本运行在不同环境,作用也不同:
立即学习“Java免费学习笔记(深入)”;
- content.js:注入到网页 DOM 中,可操作页面元素、监听事件、发消息给 background。注意它与网页脚本隔离(isolated world),不能直接访问页面变量
- background.js:作为 service worker 运行,响应事件(如安装、消息、网络请求拦截),适合做跨页面协调或定时任务。注意它是事件驱动、无持久状态的
- popup.js(配合 popup.html):用户点击插件图标时弹出的小窗口,适合放控制开关或简要信息,生命周期短
常见通信方式:chrome.runtime.sendMessage() 和 chrome.runtime.onMessage 可在 content/background/popup 之间传数据。
AJAX即“Asynchronous Javascript And XML”(异步JavaScript和XML),是指一种创建交互式网页应用的网页开发技术。它不是新的编程语言,而是一种使用现有标准的新方法,最大的优点是在不重新加载整个页面的情况下,可以与服务器交换数据并更新部分网页内容,不需要任何浏览器插件,但需要用户允许JavaScript在浏览器上执行。《php中级教程之ajax技术》带你快速
本地加载与调试
不用发布就能测试:
- 打开 Chrome 地址栏输入
chrome://extensions/ - 开启右上角「开发者模式」
- 点「加载已解压的扩展程序」,选择你插件所在的文件夹
- 出错时看「错误」链接,或在
chrome://extensions/页面点「详情」查 console 日志
content script 加载后,可在网页的 DevTools → 「Application」→ 「Content Scripts」里看到注入的 JS;background 的日志在「Service Workers」面板下查看。
打包与发布(可选)
测试通过后可打包为 .crx 文件分发,或提交到 Chrome 网上应用店:
- 打包:在
chrome://extensions/页面点击「打包扩展程序」,生成.crx和私钥.pem(请妥善保存) - 发布:需注册 Chrome 开发者账号(一次收费 5 美元),上传 zip 包,填写图标、描述、隐私政策等,审核通常 1–7 天
- 注意:Manifest V3 禁止执行字符串代码(如
eval、new Function),且不允许远程托管代码,所有 JS 必须内嵌在扩展包中
基本上就这些。从写 manifest 开始,加几行 JS,加载调试,迭代优化——不复杂但容易忽略权限声明或通信时机,多看官方文档的 lifecycle 图会更清楚。










