index.md

title	slug
manifest.json	Mozilla/Add-ons/WebExtensions/manifest.json

{{AddonSidebar}}

Note

本文描述的是适用于 web 扩展技术的 manifest.json。若你正在寻找适用于 PWA 的 manifest.json 的有关信息，请参考这篇文章：Web App 清单。

manifest.json 是每个使用 WebExtension API 的扩展必须包含的唯一文件。

通过使用 manifest.json，你可以指定扩展的基本元数据，例如名称和版本，还可以指定扩展各个方面的功能（例如后台脚本、内容脚本和某些浏览器行为）。

它是一个允许使用“//”撰写单行注释的、特殊的 JSON 文件。

manifest.json 键列表

这些是 manifest.json 键；除非另有说明，否则这些键在 Manifest V2 及以上版本中可用：

• action（Manifest V3 及以上）
• author
• background
• browser_action（仅 Manifest V2）
• browser_specific_settings
• chrome_settings_overrides
• chrome_url_overrides
• commands
• content_scripts
• content_security_policy
• declarative_net_request
• default_locale
• description
• developer
• devtools_page
• dictionaries
• externally_connectable
• homepage_url
• host_permissions（Manifest V3 及以上）
• icons
• incognito
• manifest_version
• name
• offline_enabled
• omnibox
• optional_permissions
• options_page
• options_ui
• page_action（仅 Chrome 中的 Manifest V2）
• permissions
• protocol_handlers
• short_name
• sidebar_action
• storage
• theme
• theme_experiment
• user_scripts（仅 Manifest V2）
• version
• version_name
• web_accessible_resources

关于 manifest.json 键的注意事项

• "manifest_version"、"version" 和 "name" 是唯一的强制必填键。
• 如果“\_locales”目录存在，"default_locale" 也必须相应存在，否则不应存在。
• Google Chrome 不支持 "browser_specific_settings"。

在运行时访问 manifest.json 键

你可以在拓展的 JavaScript 代码中通过 {{WebExtAPIRef("runtime.getManifest()")}} 函数访问拓展的清单数据：

browser.runtime.getManifest().version;

示例

下面的代码块显示了一些常用清单键的基本语法。

Note

本示例并非用于直接复制粘贴。根据你要开发的扩展选择相应的键。

有关完整的扩展示例，请参阅扩展示例。

{
  "browser_specific_settings": {
    "gecko": {
      "id": "[email protected]",
      "strict_min_version": "42.0"
    }
  },

  "background": {
    "scripts": ["jquery.js", "my-background.js"]
  },

  "browser_action": {
    "default_icon": {
      "19": "button/geo-19.png",
      "38": "button/geo-38.png"
    },
    "default_title": "Whereami?",
    "default_popup": "popup/geo.html"
  },

  "commands": {
    "toggle-feature": {
      "suggested_key": {
        "default": "Ctrl+Shift+Y",
        "linux": "Ctrl+Shift+U"
      },
      "description": "Send a 'toggle-feature' event"
    }
  },

  "content_security_policy": "script-src 'self' https://example.com; object-src 'self'",

  "content_scripts": [
    {
      "exclude_matches": ["*://developer.mozilla.org/*"],
      "matches": ["*://*.mozilla.org/*"],
      "js": ["borderify.js"]
    }
  ],

  "default_locale": "en",

  "description": "…",

  "icons": {
    "48": "icon.png",
    "96": "[email protected]"
  },

  "manifest_version": 2,

  "name": "…",

  "page_action": {
    "default_icon": {
      "19": "button/geo-19.png",
      "38": "button/geo-38.png"
    },
    "default_title": "Whereami?",
    "default_popup": "popup/geo.html"
  },

  "permissions": ["webNavigation"],

  "version": "0.1",

  "user_scripts": {
    "api_script": "apiscript.js"
  },

  "web_accessible_resources": ["images/my-image.png"]
}

浏览器兼容性

有关所有清单键及其子键的完整概览，请参阅完整的 manifest.json 浏览器兼容性表。

{{Compat}}

参见

{{WebExtAPIRef("permissions")}} JavaScript API