【教程向】从零开始创建浏览器插件(二)深入理解 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 扩展!

相关推荐
CoderLiu16 分钟前
用这个MCP,只给大模型一个figma链接就能直接导出图片,还能自动压缩上传?
前端·llm·mcp
伍哥的传说19 分钟前
鸿蒙系统(HarmonyOS)应用开发之实现电子签名效果
开发语言·前端·华为·harmonyos·鸿蒙·鸿蒙系统
海的诗篇_1 小时前
前端开发面试题总结-原生小程序部分
前端·javascript·面试·小程序·vue·html
uncleTom6661 小时前
前端地图可视化的新宠儿:Cesium 地图封装实践
前端
lemonzoey1 小时前
无缝集成 gemini-cli 的 vscode 插件:shenma
前端·人工智能
老家的回忆1 小时前
jsPDF和html2canvas生成pdf,组件用的elementplus,亲测30多页,20s实现
前端·vue.js·pdf·html2canvas·jspdf
半点寒12W2 小时前
uniapp全局状态管理实现方案
前端
Vertira2 小时前
pdf 合并 python实现(已解决)
前端·python·pdf
牧杉-惊蛰2 小时前
uniapp微信小程序css中background-image失效问题
css·微信小程序·uni-app
PeterJXL2 小时前
Chrome 下载文件时总是提示“已阻止不安全的下载”的解决方案
前端·chrome·安全