【教程向】从零开始创建浏览器插件(二)深入理解 Chrome 扩展的 manifest.json 配置文件

第二步:深入理解 Chrome 扩展的 manifest.json 配置文件

上一次我们已经着手完成了一个自己的浏览器插件,链接在这里:我是链接

在本篇博客中,我们将更详细地探讨 Chrome 扩展中的 manifest.json 文件。这个文件是每个浏览器扩展不可或缺的核心,它不仅定义了扩展的基本元数据,而且还规定了扩展的行为和权限。我们将深入探讨各种常用配置,并提供具体的代码示例以帮助您更好地理解和运用这些配置。

manifest.json 基本结构

每个 Chrome 扩展的 manifest.json 文件都必须包含以下基本字段:

  • manifest_version (必需):指明 manifest 文件的版本。目前版本为 3。
  • name (必需):扩展程序的名称。
  • version (必需):扩展程序的版本号。

一个简单的 manifest.json 文件看起来像这样:

json 复制代码
{
  "manifest_version": 3,
  "name": "Sample Extension",
  "version": "1.0"
}

常用配置详解

描述和图标

  • description:对扩展功能的简短描述。
  • icons:一个对象,定义了一系列图标,这些图标将在扩展目录、地址栏旁的扩展按钮以及其他界面中使用。
json 复制代码
"description": "A simple Chrome extension example.",
"icons": {
  "16": "icon16.png",
  "48": "icon48.png",
  "128": "icon128.png"
}

背景脚本

  • background :包含 service_worker 指向的脚本在扩展安装后立即持续运行,通常用于处理事件监听和维持扩展的生命周期。
json 复制代码
"background": {
  "service_worker": "background.js"
}

弹出页面

  • action:定义扩展的默认弹出行为,包括弹窗页面路径与默认图标。
json 复制代码
"action": {
  "default_popup": "popup.html",
  "default_icon": "icon48.png"
}

权限

  • permissions:扩展请求访问的 API 权限和其他特权。
json 复制代码
"permissions": [
  "storage",
  "tabs",
  "http://*/*",
  "https://*/*"
]

内容脚本

  • content_scripts:定义在特定页面自动注入的脚本和CSS。你可以指定脚本和CSS应应用到的网页URL模式。
json 复制代码
"content_scripts": [
  {
    "matches": ["http://*.example.com/*", "https://*.example.com/*"],
    "js": ["content.js"],
    "css": ["style.css"]
  }
]

选项页面

  • options_pageoptions_ui:指定一个HTML文件,用于配置扩展的选项。
json 复制代码
"options_ui": {
  "page": "options.html",
  "open_in_tab": true
}

主机权限

  • host_permissions:允许扩展访问列表中的网站。
json 复制代码
"host_permissions": [
  "http://*/*",
  "https://*/*"
]

小结

manifest.json 文件是浏览器扩展的核心,通过它可以精细地控制扩展的各种行为和权限设置。了解并正确使用这些配置项将帮助你高效地开发功能复杂的扩展程序。记得根据扩展的特定需求选择合适的配置项,以确保功能的实现和用户的安全。

希望这篇文章能帮助你更深入地理解和使用 manifest.json,并创建出功能强大、用户友好的 Chrome 扩展!

相关推荐
光影少年3 小时前
angular生态及学习路线
前端·学习·angular.js
記億揺晃着的那天5 小时前
Vue + Element UI 表格自适应高度如何做?
javascript·vue.js·ui
无尽夏_5 小时前
HTML5(前端基础)
前端·html·html5
Jagger_5 小时前
敏捷开发流程-精简版
前端·后端
FIN66686 小时前
昂瑞微冲刺科创板:创新驱动,引领射频芯片国产化新征程
前端·安全·前端框架·信息与通信·芯片
GISer_Jing6 小时前
ByteDance——jy真题
前端·javascript·面试
睡美人的小仙女1276 小时前
浏览器为何屏蔽本地文件路径?
前端
真的想不出名儿6 小时前
Vue 中 props 传递数据的坑
前端·javascript·vue.js
FIN66686 小时前
昂瑞微:深耕射频“芯”赛道以硬核实力冲刺科创板大门
前端·人工智能·科技·前端框架·信息与通信·智能
阳光阴郁大boy6 小时前
星座运势网站技术解析:从零打造现代化Web应用
前端·javascript