Skip to content

谷歌插件开发文档

权限列表

关键词描述
accessibilityFeatures.modify允许修改无障碍功能的状态
accessibilityFeatures.read允许读取无障碍功能的状态
activeTab通过用户手势临时访问使用中的标签页
alarms代码定期运行或在未来的指定时间运行
audio系统的音频设备的信息并控制这些设备
background后台操作
bookmarks书签操作
browsingData用户的本地个人资料中移除浏览数据
certificateProviderTLS 身份验证
clipboardRead读取剪贴板
clipboardWrite设置剪贴板
contentSettings设置
contextMenus上下文菜单
cookies
debugger
declarativeContent根据网页内容执行操作,而无需拥有读取网页内容的权限
declarativeNetRequest声明式规则来屏蔽或修改网络请求
declarativeNetRequestWithHostAccess
declarativeNetRequestFeedback
dns域名解析
desktopCapture截取屏幕
documentScan发现和检索连接的文档扫描器中的图片
downloads下载权限
downloads.open向下兼容的下载权限
downloads.ui更改与当前浏览器配置文件相关联的每个窗口的下载界面
enterprise.deviceAttributes读取设备属性
enterprise.hardwarePlatform获取运行浏览器的硬件平台的制造商和型号
enterprise.networkingAttributes读取有关当前网络的信息
enterprise.platformKeys生成密钥并为这些密钥安装证书
favicon读出您所访问的网站的图标
fileBrowserHandler实现文件浏览器处理程序
fileSystemProvider操作系统的文件管理器访问的文件系统
fontSettings设置取决于某些通用字体系列和语言脚本
gcm通过 Firebase Cloud Messaging (FCM) 发送和接收消息
geolocation定位
history浏览记录
identity获取 OAuth2 访问令牌
identity.email获取 OAuth2 访问令牌注册的邮箱
idle检测机器的空闲状态何时发生变化
loginState读取和监控登录状态
management提供了多种方法来管理已安装的应用和扩展程序
nativeMessaging与原生应用交换消息
notifications消息通知
offscreen创建和管理屏幕外文档
pageCapture可将标签页保存为 MHTML
platformKeys访问由平台管理的客户端证书
power替换系统的电源管理功能
printerProvider公开了打印管理器用于查询由扩展程序控制的打印机、查询其功能以及向这些打印机提交打印作业的事件
printing将打印任务发送到安装在 Chromebook 上的打印机
printingMetrics提取有关打印使用情况的数据。
privacy控制 Chrome 中可能会影响用户隐私的功能的使用情况
processes与浏览器的进程进行交互
proxy管理 Chrome 的代理设置
readingList读取和修改阅读清单中的项
runtime检索服务工件、返回清单的详细信息,以及监听和响应扩展程序生命周期中的事件。您还可以使用此 API 将网址的相对路径转换为完全限定网址。
scripting在不同上下文中执行脚本
search通过默认提供程序进行搜索
sessions从浏览会话中查询和恢复标签页及窗口。
sidePanel可将浏览器侧边栏中的内容与网页的主要内容一同托管。
storage存储、检索和跟踪用户数据的更改
system.cpu查询 CPU 元数据
system.display查询展示元数据。
system.memory内存信息
system.storage查询存储设备信息,并在连接和分离可移动存储设备时收到通知
tabCapture与标签页媒体流进行交互
tabGroups与浏览器的标签页分组系统进行交互
tabs浏览器的标签页系统进行交互。您可以使用此 API 在浏览器中创建、修改和重新排列标签页。
topSites访问新标签页上显示的热门网站(即最常访问的网站)。不包括用户自定义的快捷方式
tts播放合成的文字转语音 (TTS)
ttsEngine通过扩展程序实现文本转语音(TTS) 引擎
unlimitedStorage允许扩展程序使用无限量的存储空间
vpnProvider实现 VPN 客户端。
wallpaper更改 ChromeOS 壁纸。
webAuthenticationProxy远程主机上运行的远程桌面软件可以拦截 Web Authentication API (WebAuthn) 请求,以便在本地客户端上处理这些请求。
webNavigation接收有关飞行中导航请求状态的通知。
webRequest可观察和分析流量,以及拦截、阻止或修改传输中的请求。
webRequestBlocking可观察和分析流量,以及拦截、阻止或修改传输中的请求。

入口类型

关键词描述
Popup弹窗
Newtabtab标签
SidePanel侧边栏
Background后台
ServiceWorker服务工作线程
ContentScript内容脚本
Action动作
Command命令
ContentScript内容脚本

配置文件

manifest.json
json
{
  "manifest_version": 3,
  "name": "Minimal Manifest",
  "version": "1.0.0",
  "description": "A basic example extension with only required keys",
  "icons": {
    "48": "images/icon-48.png",
    "128": "images/icon-128.png"
  },
  // 注册内容脚本
  "content_scripts": [
    {
      "js": [
        "content-script.js"
      ],
      "matches": [
        "http://*.example.com//"
      ]
    }
  ],
  // 指定包含扩展程序服务工作线程的 JavaScript 文件,该服务工作线程充当事件处理脚本
  "background": {
    "service_worker": "service-worker.js"
  },
  // 定义 Google 工具栏中扩展程序图标的外观和行为
  "action": {
    "default_icon": {
      "16": "images/icon-16.png",
      "32": "images/icon-32.png",
      "48": "images/icon-48.png",
      "128": "images/icon-128.png"
    },
    // 定义弹出框
    "default_popup": "popup.html"
  },
  // 用于标识要在 sidePanel 中显示的 HTML 文件
  "side_panel": {
    "default_path": "sidepanel.html"
  },
  // 列出您的扩展程序可以与之互动的网页,这些网页是使用网址匹配模式定义的
  "host_permissions": [ 
    "https://*.example.com/"
  ],
  // 权限
  "permissions": ["scripting", "activeTab"],
  // 在扩展程序中定义键盘快捷键
  "commands": {}
}

wxt