版本说明
了解 Chrome 稳定版中对开发者有影响的变更。
清单版本
Updated 2025年3月6日
一个整数，用于指定您的软件包所需的清单文件格式版本。从 Chrome 开始 18 中，开发者 应该 指定 2 （不带引号），以便使用本说明中所述的格式 文档： 考虑从 Chrome 18 开始 弃用 清单版本 1。版本 2 目前并非 必需 ，但我们 在不久的将来，我们会停止支持使用已弃用的软件包 清单版本。尚未准备好跳转到 新的清单版本，可以明确指定版本 1 ，也可以不启用该密钥 如需详细了解清单文件格式的版本 1 和版本 2 之间的不同之处， manifest_version 文档。
存储区域的清单
Updated 2025年3月6日
与 local 和 sync 存储区域不同， managed 存储区域的结构必须为 声明为 JSON 架构 ，并经过 Chrome 的严格验证。此架构必须存储在 （由 "storage" 清单键的 "managed_schema" 属性指示）文件，并声明 应用支持的企业政策。 政策类似于选项，但是由系统管理员（而不是用户）配置的 从而为组织的所有用户预先配置应用。了解 Chrome 如何处理 政策 。 声明政策后，您可以通过 storage.managed API
清单 - 已启用离线功能
Updated 2025年3月6日
应用或扩展程序是否可离线工作。当 Chrome 检测到自己处于离线状态时，将在“新标签页”页面上突出显示此字段设为 true 的应用。 从 Chrome 35 开始，除非应用请求 "webview" 权限，否则应用被视为已启用离线功能，且 "offline_enabled" 的默认值为 true 。在这种情况下，系统会假定网络连接是必需的，并且 "offline_enabled" 默认为 false 。 "offline_enabled" 值还可用于确定在 ChromeOS 自助服务终端模式
清单 - 图标
Updated 2025年3月6日
代表扩展程序、应用或主题的一个或多个图标。您应始终提供 128x128 图标；安装期间以及由 Chrome 应用商店使用。扩展程序还应提供 48x48 的图标，在扩展程序管理页面 (chrome://extensions) 中使用。您还可以 指定将用作扩展程序页面的网站图标的 16x16 图标。 图标通常应采用 PNG 格式，因为 PNG 可最有效地支持透明度。他们 不过，可以采用 WebKit 支持的任何格式，包括 BMP、GIF、ICO 和 JPEG。这里有 指定图标的示例： 如果您使用
清单 - 名称和简称
Updated 2025年3月6日
name 和 short_name 清单属性是用于标识应用的简短纯文本字符串。您可以为这两个字段指定特定于语言区域的字符串；如需了解详情，请参阅 国际化 。 name （最多 45 个字符）是应用的主要标识符，是必填字段。 它显示在以下位置： short_name （建议不超过 12 个字符）是应用名称的简短版本。这是一个可选字段，如果未指定，则系统会使用 name ，但可能会将其截断。通常在没有足够空间来显示全名时使用简称，例如：
更新：活动页和后台页
Updated 2025年3月6日
清单文件格式
Updated 2025年3月6日
每个应用都有一个 JSON 格式的清单文件，名为 manifest.json ，它提供了重要的 信息。 以下代码显示了支持的 Google Apps 清单字段，其中包含指向 讨论每个字段。
已停用的网络功能
Updated 2025年3月6日
虽然 Chrome 应用使用的是网络平台，但部分网络功能已停用或以其他方式使用。这主要是为了避免安全问题和改进编程做法。下面总结了该 Web 平台已停用的功能以及可能的权宜解决方法：
清单 - 版本
Updated 2025年3月6日
一到四个以英文句点分隔的整数，用于标识此扩展程序的版本。有几项规则适用于整数：它们必须介于 0 到 65, 535 之间（包括 0 和 65, 535），并且非零整数不能以 0 开头。例如，99999 和 032 都无效。 以下是有效版本的一些示例： 自动更新系统会比较版本，以确定已安装的扩展程序是否需要更新。如果已发布的扩展程序的版本字符串比已安装的扩展程序更新，则该扩展程序会自动更新。 比较从最左边的整数开始。如果这些整数相等，则比较右侧的整数，依此类推。例如，1.2.0 是比
清单 - 要求
Updated 2025年3月6日
应用或扩展程序所需的技术。Chrome 应用商店等托管网站可能会使用 此列表以阻止用户安装无法在其计算机上正常运行的应用程序或扩展程序。 支持的要求目前包括“3D”和“插件”；可能还需要检查 。 “3D”表示 GPU 硬件加速。“webgl”是指 WebGL， API 。有关 Chrome 浏览器 3D 图形支持的详情，请参见关于 WebGL 和 3D 的帮助文章。 图形 。您可以列出应用所需的 3D 相关功能，如 示例： “插件”要求指明应用程序或扩展程序是否需要 NPAPI
清单 - 沙盒
Updated 2025年3月6日
警告 ：从版本 57 开始，Chrome 将不再允许使用外部 Web 内容（包括 嵌入式框架和脚本）。请改用 网页视图 。 定义要在沙盒化的唯一源中提供的一组应用或扩展程序页面。 以及要与它们搭配使用的内容安全政策处于沙盒中有两个影响： 沙盒化页面不受其余组件所使用的 内容安全政策 (CSP) 的约束 应用或扩展程序（具有自己单独的 CSP 值）。也就是说，它可以 使用内嵌脚本和 eval 。 例如，以下代码展示了如何指定在具有 自定义 CSP： 如果未指定，则默认的
externally_connectable
Updated 2025年3月6日
externally_connectable 清单属性用于声明哪些扩展程序、应用和网页可以 通过 runtime.connect 和 runtime.sendMessage 连接到您的应用。 有关消息传递的教程，请参阅 跨扩展程序和应用消息传递 和 发送消息 来自网页 。 如果未在应用清单中声明 externally_connectable ，则所有扩展程序和应用都可以 已连接，但所有网页都无法连接。因此，当您更新清单以使用 externally_connectable ，如果未指定
清单 - Nacl 模块
Updated 2025年3月6日
从 MIME 类型到处理每种类型的 Native Client 模块的一个或多个映射。对于 以下代码段中粗体代码会将 Native Client 模块注册为 OpenOffice 电子表格 MIME 类型的处理程序。 “path”的值是 Native Client 清单（.nmf 文件）在扩展程序中的位置 目录。有关 Native Client 和.nmf 文件的详情，请参见 Native Client 技术 概览 。 每个 MIME 类型只能与一个.nmf 文件相关联，但单个.nmf
清单 - 说明
Updated 2025年3月6日
描述扩展程序的纯文本字符串（无 HTML 或其他格式；不超过 132 个字符）。该说明应适合浏览器的扩展程序管理界面和 Chrome 应用商店 。您可以为此字段指定特定于语言区域的字符串；如需了解详情，请参阅 国际化 。
清单 - 键
Updated 2025年3月6日
此值可用于在开发期间加载扩展程序、应用或主题时控制其唯一 ID。 如需获取合适的键值对，请先通过.crx 文件安装扩展程序（您可能需要 上传扩展程序 或 手动将其打包 ）。然后，在 用户数据目录 中查找文件 Default/Extensions/_<extensionId>_/_<versionString>_/manifest.json 。您会看到已填充的键值对。
清单 - 默认语言区域
Updated 2025年3月6日
指定包含此扩展程序的默认字符串的 _locales 的子目录。在具有 _locales 目录的扩展程序中， 必须 填写此字段；在没有 _locales 目录的扩展程序中，此字段 必须不存在 。如需了解详情，请参阅 国际化 。
工作区流
Updated 2025年3月6日
RouteHandlerCallbackOptions StreamSource | Promise< StreamSource > 响应 ReadableStream BodyInit 接受多个来源 promise，每个 promise 都可以解析为 Response、 ReadableStream 或 BodyInit 。 返回一个对象，该对象公开了 ReadableStream 以及每个单独的流 以及一个 promise（用于指示 流完成（适用于传递给 FetchEvent 的
eBay 如何通过无缝凭据共享功能将登录成功率提高了 10%
Updated 2025年3月6日
了解 eBay 如何使用数字资产链接实现顺畅的凭据共享，从而将登录成功率提高了 10%。了解如何实现安全的跨平台身份验证并提升用户体验。
Chrome Web Store
Updated 2025年3月4日
Chrome Web Store 一个在线市场，用户可以在其中浏览扩展程序和主题。在那里发布您的扩展程序，让全世界的用户都能访问。 dashboard 开发者信息中心 发布您的扩展程序并管理您的商店商品。 local_mall Chrome Web Store 浏览 Chrome 应用商店中的扩展程序。 policy 开发者政策 为 Chrome 应用商店创建扩展程序的最佳做法和指南。 在发布您的首个扩展程序之前，请务必遵循这些步骤和最佳做法，以确保顺利提交扩展程序。 准备扩展程序文件
chrome.contentSettings
Updated 2025年2月28日
使用 chrome.contentSettings API 更改用于控制网站是否可以使用 Cookie、JavaScript 和插件等功能的设置。更一般地说，内容设置可让您针对每个网站（而非全局）自定义 Chrome 的行为。 您必须在扩展程序的清单中声明 "contentSettings" 权限，才能使用该 API。例如： 您可以使用模式来指定每项内容设置影响的网站。例如， https://*.youtube.com/* 指定了 youtube.com 及其所有子网域。内容设置模式的语法与
chrome.bookmarks
Updated 2025年2月28日
此权限会 触发警告 。 使用 chrome.bookmarks API 创建、整理和以其他方式处理书签。另请参阅 替换页面 ，您可以使用该页面创建自定义书签管理器页面。 您必须在 扩展程序清单 中声明“书签”权限，才能使用 Bookmarks API。例如： 书签采用树状结构，其中树中的每个节点都是一个书签或文件夹（有时称为 组 ）。树中的每个节点都由 bookmarks.BookmarkTreeNode 对象表示。 BookmarkTreeNode 属性在整个 chrome.bookmarks
chrome.bookmarks
Updated 2025年2月28日
使用 chrome.bookmarks API 创建、整理和以其他方式处理书签。另请参阅 替换页面 ，您可以使用该页面创建自定义书签管理器页面。 您必须在 扩展程序清单 中声明“书签”权限，才能使用 Bookmarks API。例如： 书签采用树状结构，其中树中的每个节点都是一个书签或文件夹（有时称为 组 ）。树中的每个节点都由 bookmarks.BookmarkTreeNode 对象表示。 BookmarkTreeNode 属性在整个 chrome.bookmarks API
chrome.contentSettings
Updated 2025年2月28日
使用 chrome.contentSettings API 更改用于控制网站是否可以使用 Cookie、JavaScript 和插件等功能的设置。更一般地说，内容设置可让您针对每个网站（而非全局）自定义 Chrome 的行为。 您必须在扩展程序的清单中声明“contentSettings”权限，才能使用该 API。例如： 您可以使用模式来指定每项内容设置影响的网站。例如， https://*.youtube.com/* 指定了 youtube.com 及其所有子网域。内容设置模式的语法与
人工智能
Updated 2025年2月28日
Chrome 上的 AI 欢迎来到 AI 赋能的网络时代。了解 AI 如何让开发者更轻松地打造强大的 Web 体验。 重新构想 Chrome 专用 Gemini Nano 的强大功能。 内置 AI 我们将在 Chrome 中引入 Gemini Nano，这是 Gemini 生态系统中最高效的模型。 在客户端工作 客户端 AI 为用户带来强大的模型，同时保护数据隐私并缩短延迟时间。 开始使用 了解开始使用内置 AI 构建功能和应用时需满足的要求。 可用的 API 查看可在 Chrome 中与
chrome.app.runtime
Updated 2025年2月24日
使用 chrome.app.runtime API 管理应用生命周期。应用运行时会管理应用安装、控制活动页面，并且可以随时关闭应用。 任意（可选） 可选的开发者指定数据，要嵌入的应用在做出嵌入决策时可以使用这些数据。 字符串 void 允许 embedderId 将此应用嵌入 <appview> 元素中。 url 用于指定要嵌入的内容。 allow 函数如下所示： 字符串 void 阻止 embedderId 将此应用嵌入 <appview> 元素中。 deny
chrome.printing
Updated 2025年2月24日
使用 chrome.printing API 将打印作业发送到安装在 Chromebook 上的打印机。 您需要在 扩展程序清单 中声明 "printing" 权限，才能使用所有 chrome.printing 方法和事件。例如： 以下示例演示了如何使用打印命名空间中的每种方法。此代码复制自或基于 extensions-samples GitHub 代码库中的 api-samples/printing 。 以下示例使用 onJobStatusChanged 处理脚本来在 jobStatus
chrome.userScripts
Updated 2025年2月24日
使用 userScripts API 在“用户脚本”上下文中执行用户脚本。 如需使用 User Scripts API ( chrome.userScripts )，请将 "userScripts" 权限添加到 manifest.json，并为您要运行脚本的网站添加 "host_permissions" 。 用户脚本是指注入到网页中用于修改其外观或行为的一小段代码。与其他扩展程序功能（例如 内容脚本 和 chrome.scripting API ）不同，用户脚本 API
chrome.sessions
Updated 2025年2月24日
使用 chrome.sessions API 查询和恢复浏览会话中的标签页和窗口。 字符串 外部设备的名称。 会话 [] 外部设备的打开窗口会话列表，按修改时间从最近到最久排序。 编号（可选） 要从请求的列表中提取的条目数量上限。省略此参数可提取最大条目数 ( sessions.MAX_SESSION_RESULTS )。 数值 窗口或标签页关闭或修改的时间，以自公元纪年开始计算的秒数表示。 标签页 （可选） tabs.Tab （如果此条目描述的是标签页）。系统会设置此值或
chrome.printing
Updated 2025年2月24日
使用 chrome.printing API 将打印作业发送到安装在 Chromebook 上的打印机。 您需要在 扩展程序清单 中声明 "printing" 权限，才能使用所有 chrome.printing 方法和事件。例如： 以下示例演示了如何使用打印命名空间中的每种方法。此代码复制自 extensions-samples GitHub 代码库中的 api-samples/printing ，或基于该代码库。 以下示例使用 onJobStatusChanged 处理脚本来在
chrome.sessions
Updated 2025年2月24日
使用 chrome.sessions API 查询和恢复浏览会话中的标签页和窗口。 字符串 外部设备的名称。 会话 [] 外部设备的打开窗口会话列表，按修改时间从最近到最久排序。 编号（可选） 要从请求的列表中提取的条目数量上限。省略此参数可提取最大条目数 ( sessions.MAX_SESSION_RESULTS )。 数值 窗口或标签页关闭或修改的时间，以自公元纪年开始计算的秒数表示。 标签页 （可选） tabs.Tab （如果此条目描述的是标签页）。系统会设置此值或
探索 Chrome
Updated 2025年2月21日
探索 Chrome Chrome 134（Beta 版） Chrome 133 Chrome 132 Chrome 131 Chrome 130 Chrome 129 Chrome 128 Chrome 127 Chrome 126 Chrome 125 Chrome 124 Chrome 123 Chrome 122 Chrome 121 Chrome 120 Chrome 119 Chrome 的新变化 开发者工具 开发者工具提示 工程博客 无障碍 媒体 WebGPU 博客 案例研究 视频
chrome.i18n
Updated 2025年2月12日
使用 chrome.i18n 基础架构在整个应用或扩展程序中实现国际化。 如果扩展程序包含 /_locales 目录，则 manifest 必须定义 "default_locale" 。 您需要将其所有面向用户的字符串放入名为 messages.json 的文件中。每次添加新的语言区域时，您都需要在名为 /_locales/_localeCode_ 的目录下添加一个消息文件，其中 localeCode 是一个代码，例如英语的代码为 en 。 以下是支持英语 ( en )、西班牙语 ( es )
在 Windows 上基于 Chromium 的浏览器中改进了文本渲染
Updated 2025年2月12日
Edge 团队添加了直接在 Chromium 中遵循 Windows ClearType 调谐器值的支持，从而改进了 Windows 上基于 Chromium 的浏览器中的文本渲染效果。
chrome.storage
Updated 2025年2月11日
使用 chrome.storage API 存储、检索和跟踪用户数据的更改。 如需使用 Storage API，请在扩展程序 manifest 中声明 "storage" 权限。例如： Storage API 提供了一种扩展程序专用的方法来保留用户数据和状态。它与 Web 平台的存储 API（ IndexedDB 和 Storage ）类似，但旨在满足扩展程序的存储需求。以下是一些关键功能： 虽然扩展程序可以在某些上下文（弹出式窗口和其他 HTML 页面）中使用 Storage 接口（可通过
chrome.storage
Updated 2025年2月11日
使用 chrome.storage API 存储、检索和跟踪用户数据的更改。 Storage API 提供了一种扩展程序专用的方法来保留用户数据和状态。它类似于 Web 平台的存储 API（ IndexedDB 和 Storage ），但旨在满足扩展程序的存储需求。以下是一些关键功能： 虽然扩展程序可以在某些上下文（弹出式窗口和其他 HTML 页面）中使用 [ Storage ][mdn-storage] 接口（可通过 window.localStorage
LCP 图片子部分和 RTT 现已在 CrUX 中推出
Updated 2025年2月11日
了解 2025 年 2 月版本中 Chrome 用户体验报告 (CrUX) 的变更，包括 LCP 图片子部分、LCP 资源类型和 RTT。
如何使用 CrUX BigQuery 数据集
Updated 2025年2月11日
在本指南中，您将了解如何使用 BigQuery 针对 CrUX 数据集编写查询，以提取有关网络用户体验状况的见解深刻结果。
chrome.enterprise.platformKeys
Updated 2025年2月4日
使用 chrome.enterprise.platformKeys API 生成密钥并为这些密钥安装证书。证书将由平台管理，可用于 TLS 身份验证、网络访问，或由其他扩展程序通过 chrome.platformKeys 使用。 如需使用此 API 注册客户端证书，请按以下步骤操作： 使用 enterprise.platformKeys.getTokens 获取所有可用令牌。 找到 id 等于 "user" 的令牌。之后使用此令牌。 使用 generateKey 令牌方法（在
chrome.enterprise.platformKeys
Updated 2025年2月4日
使用 chrome.enterprise.platformKeys API 生成密钥并为这些密钥安装证书。证书将由平台管理，可用于 TLS 身份验证、网络访问，或由其他扩展程序通过 chrome.platformKeys 使用。 如需使用此 API 注册客户端证书，请按以下步骤操作： 使用 enterprise.platformKeys.getTokens() 获取所有可用令牌。 找到 id 等于 "user" 的令牌。之后使用此令牌。 使用 generateKey() 令牌方法（在
chrome.runtime
Updated 2025年1月30日
使用 chrome.runtime API 检索服务工件、返回清单的详细信息，以及监听和响应扩展程序生命周期中的事件。您还可以使用此 API 将网址的相对路径转换为完全限定网址。 Runtime API 提供了多种方法来支持您的扩展程序可使用的多种功能领域： 运行时 API 上的大多数方法 不需要 任何权限，但 sendNativeMessage 和 connectNative 需要 nativeMessaging 权限。 以下示例展示了如何在清单中声明 nativeMessaging 权限：
chrome.permissions
Updated 2025年1月30日
使用 chrome.permissions API 在运行时（而不是安装时）请求 声明的可选权限 ，以便用户了解需要这些权限的原因，并仅授予必要的权限。 权限警告旨在说明 API 授予的功能，但其中一些警告可能并不明显。借助 Permissions API，开发者可以解释权限警告并逐步引入新功能，让用户能够无风险地了解扩展程序。这样，用户可以指定他们愿意授予的访问权限级别以及想要启用的功能。 例如， 可选权限扩展程序 的核心功能会替换新标签页。其中一个功能是显示用户当天的目标。此功能仅需要
chrome.permissions
Updated 2025年1月30日
使用 chrome.permissions API 在运行时（而不是安装时）请求 声明的可选权限 ，以便用户了解需要这些权限的原因，并仅授予必要的权限。 权限警告旨在说明 API 授予的功能，但其中一些警告可能并不明显。借助 Permissions API，开发者可以解释权限警告并逐步引入新功能，让用户能够无风险地了解扩展程序。这样，用户可以指定他们愿意授予的访问权限级别以及他们想要启用的功能。 例如， 可选权限扩展程序 的核心功能会替换新标签页。其中一个功能是显示用户当天的目标。此功能仅需要
WebGPU（Chrome 133）中的新变化
Updated 2025年1月29日
新增了 unorm8x4-bgra 和 1 个组成部分的顶点格式，允许使用未定义值请求未知限制，WGSL 对齐规则发生变化，WGSL 性能因舍弃而提升，等等。
Chrome 中的新变化
Updated 2025年1月23日
Chrome 中的新变化 参阅我们的文档和博客，了解 Chrome 的最新动态。 新增了内容和重大文档更新。 article LLM 如何流式传输回答 新增了文档，介绍了在 AI 中，服务器和客户端的流式数据的运作方式。 article Chrome 应用商店的通知和申诉 Chrome 应用商店的通知和申诉流程已更新。 article 源试用中的 AI API 从 Chrome 131 开始，Translator API、Summarizer API 和 Prompt API for
简化了通行密钥的 WebAuthn 功能检测
Updated 2025年1月21日
了解如何使用 `getClientCapabilities()` 检测 WebAuthn 功能，以及如何为用户量身定制身份验证工作流。
Google 密码管理工具中的通行密钥现已在 iOS 设备上推出
Updated 2025年1月16日
在 iOS 17 或更高版本上，Chrome 现在可以在 Google 密码管理工具 (GPM) 中创建、同步和使用通行密钥进行身份验证。这样一来，您就可以在任何安装了 Chrome 的设备上使用 GPM 中的通行密钥。
Chrome 132 中的新变化
Updated 2025年1月14日
Chrome 132 现已发布！Dialog 元素会获取 ToggleEvent，支持元素级视频共享，并且 FileSystem Access API 支持 Android 和 WebView。
chrome.sockets.udp
Updated 2025年1月13日
使用 chrome.sockets.udp API 通过 UDP 连接在网络上发送和接收数据。此 API 取代了之前在“socket”API 中找到的 UDP 功能。 必须在 清单 中声明以下键才能使用此 API。 数值 新创建的套接字的 ID。请注意，通过此 API 创建的套接字 ID 与通过其他 API（例如已废弃的 [ socket ](../socket/) API）创建的套接字 ID 不兼容。 DNS 解析偏好设置。默认值为 any ，并使用当前的操作系统配置，该配置可能会返回
chrome.tabs
Updated 2025年1月13日
使用 chrome.tabs API 与浏览器的标签页系统进行交互。您可以使用此 API 在浏览器中创建、修改和重新排列标签页。 Tabs API 不仅提供用于操作和管理标签页的功能，还可以检测标签页的 语言 、截取 屏幕截图 ，以及与标签页的内容脚本进行 通信 。 大多数功能无需任何权限即可使用。例如： 创建 新标签页、 重新加载 标签页、 导航 到其他网址等。 开发者在使用 Tabs API 时应注意三项权限。 此权限不会授予对 chrome.tabs
chrome.tabs
Updated 2025年1月13日
使用 chrome.tabs API 与浏览器的标签页系统进行交互。您可以使用此 API 在浏览器中创建、修改和重新排列标签页。 Tabs API 不仅提供用于操作和管理标签页的功能，还可以检测标签页的 语言 、截取 屏幕截图 ，以及与标签页的内容脚本进行 通信 。 大多数功能无需任何权限即可使用。例如： 创建 新标签页、 重新加载 标签页、 导航 到其他网址等。 开发者在使用 Tabs API 时应注意三项权限。 以下示例展示了如何在 manifest 中声明每项权限：
chrome.ttsEngine
Updated 2025年1月13日
使用 chrome.ttsEngine API 通过扩展程序实现文本转语音(TTS) 引擎。如果您的扩展程序使用此 API 进行注册，那么当任何扩展程序或 Chrome 应用使用 tts API 生成语音时，该扩展程序将会收到包含要朗读的语音和其他参数的事件。然后，您的扩展程序可以使用任何可用的 Web 技术来合成和输出语音，并将事件发送回调用函数以报告状态。 扩展程序可以将自己注册为语音引擎。这样，它就可以拦截对 tts.speak() 和 tts.stop()
chrome.cookies
Updated 2025年1月13日
使用 chrome.cookies API 查询和修改 Cookie，并在 Cookie 发生更改时收到通知。 如需使用 Cookie API，您必须在清单中声明“Cookie”权限，以及您要访问 Cookie 的所有主机的 主机权限 。例如： 借助 分区 Cookie ，网站可以标记某些 Cookie 应采用顶级框架的来源作为键。这意味着，如果网站 A 使用 iframe 嵌入到网站 B 和网站 C 中，则分区 Cookie 在每个网站中可以具有不同的值。 chrome.cookies
chrome.ttsEngine
Updated 2025年1月13日
使用 chrome.ttsEngine API 通过扩展程序实现文本转语音(TTS) 引擎。如果您的扩展程序使用此 API 进行注册，那么当任何扩展程序或 Chrome 应用使用 tts API 生成语音时，该扩展程序将收到包含要朗读的语音和其他参数的事件。然后，您的扩展程序可以使用任何可用的 Web 技术来合成和输出语音，并将事件发送回调用函数以报告状态。 扩展程序可以将自己注册为语音引擎。这样一来，它就可以拦截对 tts.speak 和 tts.stop
chrome.cookies
Updated 2025年1月13日
使用 chrome.cookies API 查询和修改 Cookie，并在 Cookie 发生更改时收到通知。 如需使用 Cookie API，请在清单中声明 "cookies" 权限，并为您要访问 Cookie 的所有主机声明 主机权限 。例如： 借助 分区 Cookie ，网站可以标记某些 Cookie 应采用顶级框架的来源作为键。例如，这意味着，如果网站 A 使用 iframe 嵌入到网站 B 和网站 C 中，则来自 A 的分区 Cookie 的嵌入版本在 B 和 C 中可以具有不同的值。
chrome.appviewTag
Updated 2025年1月13日
使用 appview 标记在您的 Chrome 应用中嵌入其他 Chrome 应用。详情请参阅 用法 。 对象 可选的开发者指定数据，要嵌入的应用在做出嵌入决策时可以使用这些数据。 字符串 发送嵌入请求的应用的 ID。 void 允许嵌入请求。 allow 函数如下所示： 字符串 指定要嵌入的内容。 void 阻止嵌入请求。 deny 函数如下所示： 请求嵌入其他应用。 字符串 要嵌入的应用的扩展程序 ID。 任意（可选） 可选的开发者指定数据，要嵌入的应用在做出嵌入决策时可以使用这些数据。
WebGPU（Chrome 132）中的新变化
Updated 2025年1月8日
纹理视图使用、32 位浮点纹理混合、GPUDevice adapterInfo 属性、使用无效格式配置画布上下文会抛出 JavaScript 错误、过滤纹理上的采样器限制、扩展的子组实验、改进开发者体验、对 16 位归一化纹理格式的实验性支持等。
chrome.certificateProvider
Updated 2024年12月22日
使用此 API 将证书公开给平台，平台可以使用这些证书进行 TLS 身份验证。 如需使用此 API 向 ChromeOS 公开客户端证书，请按以下步骤操作： 实际步骤顺序可能会有所不同。例如，如果使用用于自动选择证书的企业政策，系统将不会要求用户选择证书（请参阅 AutoSelectCertificateForUrls 和 面向用户的 Chrome 政策 ）。 在扩展程序中，这可能类似于以下代码段： 支持的加密签名算法类型。 "RSASSA_PKCS1_v1_5_MD5_SHA1" 使用
chrome.extension
Updated 2024年12月22日
chrome.extension API 包含可供任何扩展程序页面使用的实用程序。它支持在扩展程序及其内容脚本之间或扩展程序之间交换消息，如 消息传递 中所详述。 扩展程序视图的类型。 "tab" "popup" 对于在无痕式标签页中运行的内容脚本，以及在无痕式进程中运行的扩展程序页面，此值为 true。后者仅适用于具有“split”incognito_behavior 的扩展程序。 布尔值 返回当前扩展程序中运行的后台页面的
chrome.system.display
Updated 2024年12月21日
使用 system.display API 查询显示元数据。 一个枚举，用于指明系统是否检测到显示屏并使用了显示屏。如果系统未检测到显示屏（可能已断开连接，或因进入休眠模式等原因而被视为已断开连接），则系统会将显示屏视为“非活跃”。例如，此状态用于在所有显示屏断开连接时保留现有显示屏。 "active" "inactive" 数值 显示屏的高度（以像素为单位）。 数值 左上角的 x 坐标。 数值 左上角的 y 坐标。 数值 显示屏的宽度（以像素为单位）。 字符串 显示屏的唯一标识符。 数值
chrome.system.display
Updated 2024年12月21日
使用 system.display API 查询显示元数据。 一个枚举，用于指明系统是否检测到显示屏并使用了显示屏。如果系统未检测到显示屏（可能已断开连接，或因进入休眠模式等原因而被视为已断开连接），则系统会将显示屏视为“非活跃”。例如，此状态用于在所有显示屏断开连接时保留现有显示屏。 "active" "inactive" 数值 显示屏的高度（以像素为单位）。 数值 左上角的 x 坐标。 数值 左上角的 y 坐标。 数值 显示屏的宽度（以像素为单位）。 字符串 显示屏的唯一标识符。 数值
chrome.action
Updated 2024年12月21日
使用 chrome.action API 控制 Google Chrome 工具栏中的扩展程序图标。 必须在 清单 中声明以下键才能使用此 API。 如需使用 chrome.action API，请指定 3 的 "manifest_version" ，并在 清单文件 中添加 "action" 键。 "action" 键（及其子项）是可选的。如果未包含该图标，您的扩展程序仍会显示在工具栏中，以便用户访问扩展程序的菜单。因此，我们建议您始终至少添加 "action" 和 "default_icon"
chrome.commands
Updated 2024年12月21日
使用 Commands API 添加可在扩展程序中触发操作的键盘快捷键，例如用于打开浏览器操作或向扩展程序发送命令的操作。 必须在 清单 中声明以下键才能使用此 API。 借助 Commands API，扩展程序开发者可以定义特定命令，并将其绑定到默认的按键组合。扩展程序接受的每个命令都必须在 扩展程序清单 中声明为 "commands" 对象的属性。 属性键将用作命令的名称。命令对象可以采用两个属性。
使用远程调试时不支持此操作
Updated 2024年12月21日
某些 WebDriver 命令（例如调整浏览器窗口大小）需要将 Chrome 扩展程序加载到浏览器中。ChromeDriver 通常会在每次启动新的 Chrome 会话时加载此“自动化扩展程序”。 不过，ChromeDriver 可以被指示连接到现有 Chrome 会话，而不是启动新的会话。为此，请使用 Capabilities （也称为
ChromeOS
Updated 2024年12月18日
所有 ChromeOS 测试映像均在 /usr/local/chromedriver/ 中安装了 ChromeDriver 二进制文件。该二进制文件会更新为该测试映像中的相同版本的 Chrome。也就是说，您始终使用的是最新版 ChromeDriver。 如果您的测试预计将针对 ChromeDriver 二进制文件的稳定 build 运行，您需要在测试中编写自己的代码来下载特定二进制文件，并替换 /usr/local/chromedriver/ 中的二进制文件。 您可以编写一个使用
chrome.certificateProvider
Updated 2024年12月18日
使用此 API 将证书公开给平台，平台可以使用这些证书进行 TLS 身份验证。 如需使用此 API 向 ChromeOS 公开客户端证书，请按以下步骤操作： 实际步骤顺序可能会有所不同。例如，如果使用自动选择证书的企业政策，系统就不会要求用户选择证书（请参阅 AutoSelectCertificateForUrls 和 面向用户的 Chrome 政策 ）。 在扩展程序中，这可能类似于以下代码段： 支持的加密签名算法类型。 "RSASSA_PKCS1_v1_5_MD5_SHA1" 使用
chrome.extension
Updated 2024年12月18日
chrome.extension API 包含可供任何扩展程序页面使用的实用程序。它支持在扩展程序及其内容脚本之间或扩展程序之间交换消息，如 消息传递 中所详述。 扩展程序视图的类型。 "tab" "popup" 对于在无痕式标签页中运行的内容脚本，以及在无痕式进程中运行的扩展程序页面，此值为 true。后者仅适用于具有“split”incognito_behavior 的扩展程序。 布尔值 请使用 runtime.lastError 。 如果异步扩展程序 API
性能日志
Updated 2024年12月17日
ChromeDriver 支持性能日志记录，您可以通过该日志获取“时间轴”“网络”和“网页”网域的事件，以及指定轨迹类别的 轨迹数据 。 默认情况下，系统不会启用性能日志记录功能。因此，在创建新会话时，您必须启用此功能。 启用后，性能日志会收集时间轴、网络和网页事件。如需同时启用跟踪功能或自定义性能日志记录，请继续阅读。 查看由 Michael Klepikov 撰写的 使用默认选项的性能日志记录完整示例 。 Angular Benchpress 也使用性能日志记录。
下载内容
Updated 2024年12月17日
以下是支持较低版本 Chrome 的 ChromeDriver 版本。 如需详细了解如何选择正确的 ChromeDriver 版本，请参阅 版本选择 页面。 支持 Chrome 114 版 如需了解详情，请参阅 版本说明 。 支持 Chrome 114 版 如需了解详情，请参阅 版本说明 。 支持 Chrome 113 版 如需了解详情，请参阅 版本说明 。 支持 Chrome 113 版 如需了解详情，请参阅 版本说明 。 支持 Chrome 112 版 如需了解详情，请参阅 版本说明 。
ChromeDriver 崩溃
Updated 2024年12月17日
如需诊断和修复 ChromeDriver 崩溃问题，您可以选择以下几种方法。这仅适用于 ChromeDriver 崩溃，而非 Chrome 崩溃或关闭。 在 Windows 上，您可能会看到如下内容： 创建一个重现问题的用例，以便 ChromeDriver 贡献者使用该用例来重现和调试问题。即使崩溃并非 100% 发生，也无妨。 请提交 bug 并附上重现问题的测试用例。这通常是获得帮助的最快方式。 如需创建和调试崩溃转储，您需要使用调试版 ChromeDriver。我们没有
Chrome 无法立即启动或崩溃
Updated 2024年12月17日
使用特殊的测试框架（可能是 IDE）或持续构建系统（例如 Jenkins）运行 ChromeDriver 或 Chrome 时，这种情况经常会发生。 尝试从普通用户命令提示符启动与您的测试使用的相同 Chrome 二进制文件。确认 chromedriver.log 文件中使用的 Chrome 二进制文件。如果您向 Chrome 传递特殊的命令行开关或参数，请务必也将它们包含在内。如果 Chrome 未能正常启动，您需要修正 Chrome 的安装。请尝试重新安装。 假设您可以通过命令提示运行
移动设备模拟
Updated 2024年12月17日
Chrome 允许用户通过 使用 Chrome 开发者工具启用设备模式 ，在桌面版 Chrome 中模拟移动设备上的 Chrome。此功能可加快 Web 开发速度，让开发者无需使用真实设备，即可快速测试网站在移动设备中的呈现方式。ChromeDriver 还可以使用字典值指定的“mobileEmulation”功能来模拟设备。 与开发者工具一样，ChromeDriver 中也有两种方法可以启用移动设备模拟： “mobileEmulation”字典的格式取决于所需的方法。
键盘支持
Updated 2024年12月17日
目前，ChromeDriver 仅支持配置了美国键盘的系统。 当 ChromeDriver 检测到此状态时，会记录以下内容： 没有美国键盘的用户在执行 sendKeys 或 TypeElement 命令时可能会遇到按键丢失的问题。 作为一种权宜解决方法，我们建议此类用户在系统配置中将采用 QWERTY 布局的美国键盘添加为次要选项。这样一来，ChromeDriver 便可使用美国键盘配置。 一如既往，ChromeDriver 是一个开源项目，我们欢迎您贡献代码。
Android
Updated 2024年12月17日
最新的 ChromeDriver 二进制文件 已打包为适用于各种主机平台的 ZIP 文件。 您可以在 下载 部分找到较低版本的 ChromeDriver。 ChromeDriver 支持在 Chrome 浏览器（30 及更高版本）以及启用了 Web 调试 和 JavaScript 的 Android 4.4 (KitKat) 及更高版本中基于 WebView 的应用上运行测试。 您可以通过以下方式安装 Chrome 应用： 稳定版：
Canary 版
Updated 2024年12月17日
ChromeDriver Canary 版包含最新的 ChromeDriver 功能。系统每天都会构建和提供多个新的二进制文件。 请注意，此版本专为开发者和早期采用者设计，有时可能会完全崩溃。 从 M115 开始，Chrome 测试版可用性信息中心会提供每个发布渠道（包括 Canary 渠道）的最新 Chrome + ChromeDriver 版本。如需自动下载版本，您可以使用方便的 JSON 端点。 对于较低版本，您可以按如下方式找到 Canary build： 通常，最好选择最新的
CSS Wrapped 2024
Updated 2024年12月5日
加入 Chrome DevRel 团队和滑板 Chrome Dino，一起探索 2024 年为 Chrome 和 Web 平台推出的最新 CSS。
chrome.socket
Updated 2024年11月30日
使用 chrome.socket API 通过 TCP 和 UDP 连接在网络上发送和接收数据。 注意 ：从 Chrome 33 开始，此 API 已废弃，取而代之的是 sockets.udp 、 sockets.tcp 和 sockets.tcpServer API。 数值 number 可选 已接受的套接字的 ID。 数值 新创建的套接字的 ID。 字符串 可用的 IPv4/6 地址。 字符串 适配器的底层名称。在 *nix 上，这通常为“eth0”“lo”等。 数值 前缀长度
chrome.bluetoothSocket
Updated 2024年11月30日
使用 chrome.bluetoothSocket API 通过 RFCOMM 和 L2CAP 连接向蓝牙设备发送和接收数据。 必须在 清单 中声明以下键才能使用此 API。 "system_error" 系统发生错误，连接可能无法恢复。 "not_listening" 套接字未监听。 AcceptError 一个错误代码，用于指明出现了什么问题。 字符串 错误消息。 数值 服务器套接字标识符。 数值 客户端套接字标识符，即新建立的连接的套接字标识符。此套接字标识符应仅与
chrome.browser
Updated 2024年11月30日
使用 chrome.browser API 与与当前应用和 Chrome 个人资料关联的 Chrome 浏览器进行交互。 字符串 新标签页初次打开时要导航到的网址。 在与当前应用和 Chrome 个人资料关联的浏览器窗口中打开新标签页。如果未打开 Chrome 个人资料的浏览器窗口，系统会先打开一个新窗口，然后再创建新标签页。 OpenTabOptions 配置标签页的打开方式。 函数（可选） callback 参数如下所示： Promise<void> 只有 Manifest V3
chrome.syncFileSystem
Updated 2024年11月30日
使用 chrome.syncFileSystem API 在 Google 云端硬盘上保存和同步数据。此 API 不适用于访问存储在 Google 云端硬盘中的任意用户文档。它提供应用专用可同步存储空间，以供离线和缓存使用，这样一来，相同的数据便可在不同的客户端中使用。如需详细了解如何使用此 API，请参阅 管理数据 。 "last_write_win" “manual” SyncAction （可选） 执行的同步操作，用于触发 onFileStatusChanged 事件。操作值可以是
chrome.bluetooth
Updated 2024年11月30日
使用 chrome.bluetooth API 连接到蓝牙设备。所有函数均通过 chrome.runtime.lastError 报告失败。 必须在 清单 中声明以下键才能使用此 API。 字符串 适配器的地址，格式为“XX:XX:XX:XX:XX:XX”。 布尔值 指示适配器是否可用（即是否已启用）。 布尔值 指示适配器当前是否正在进行发现。 字符串 适配器的直观易懂的名称。 布尔值 指示适配器是否已接通电源。 FilterType （过滤条件类型）- 可选
chrome.mdns
Updated 2024年11月30日
使用 chrome.mdns API 通过 mDNS 发现服务。这包含 NSD 规范的部分功能：http://www.w3.org/TR/discovery-api/ 字符串 mDNS 通告服务的 IP 地址。 字符串[] mDNS 通告服务的元数据。 字符串 mDNS 通告服务的主机：端口对。 字符串 mDNS 通告服务的服务名称，... onServiceList 事件中包含的服务实例的数量上限。如果有更多实例可用，系统可能会从 onServiceList 事件中截断这些实例。 2048
chrome.serial
Updated 2024年11月30日
使用 chrome.serial API 对连接到串行端口的设备执行读写操作。 number 可选 请参阅 ConnectionOptions.bitrate 。如果使用非标准比特率，或者在查询底层设备时发生错误，此字段可能会被省略或不准确。 数值 查看 ConnectionOptions.bufferSize 数值 串行端口连接的 ID。 布尔值（可选） 请参阅 ConnectionOptions.ctsFlowControl 。如果在查询底层设备时发生错误，则可以省略此字段。
chrome.bluetoothLowEnergy
Updated 2024年11月30日
chrome.bluetoothLowEnergy API 用于使用 Generic Attribute Profile (GATT) 与蓝牙智能 (Low Energy) 设备通信。 必须在 清单 中声明以下键才能使用此 API。 ManufacturerData [] 可选 要包含在广告数据的“制造商专用数据”字段中的制造商专用数据的列表。 ServiceData [] 可选 要包含在广告数据的“服务数据”字段中的服务数据列表。 string[] 可选 要添加到广告数据的“服务
chrome.webviewTag
Updated 2024年11月30日
使用 webview 标记可通过网络主动加载来自网络的直播内容，并将其嵌入到 Chrome 应用中。您的应用可以控制 webview 的外观，与网络内容互动，在嵌入的网页中发起导航，对其中发生的错误事件做出响应，等等（请参阅 用法 ）。 用于确定 clearData 应清除哪些数据的选项。 number 可选 清除在此日期当天或之后累积的数据，以从公元纪年起算的毫秒数表示（可通过 JavaScript Date 对象的 getTime 方法访问）。如果不存在，则默认为 0
chrome.fontSettings
Updated 2024年11月30日
使用 chrome.fontSettings API 管理 Chrome 的字体设置。 如需使用 Font Settings API，您必须在 扩展程序清单 中声明 "fontSettings" 权限。例如： Chrome 允许某些字体设置取决于某些通用字体系列和语言脚本。例如，用于 sans-serif 简体中文的字体可能与用于 serif 日语的字体不同。 Chrome 支持的通用字体系列基于 CSS 通用字体系列 ，并在 GenericReference
chrome.usb
Updated 2024年11月30日
使用 chrome.usb API 与已连接的 USB 设备进行互动。此 API 可从应用上下文中访问 USB 操作。借助此 API，应用可以充当硬件设备的驱动程序。通过设置 runtime.lastError 并执行函数的常规回调来报告此 API 生成的错误。在这种情况下，回调的常规参数将未定义。 布尔值 这是有效配置吗？ number 配置编号。 字符串（可选） 配置说明。 ArrayBuffer 与此配置相关联的额外描述符数据。 InterfaceDescriptor [] 可用的接口。
chrome.desktopCapture
Updated 2024年11月25日
Desktop Capture API 可截取屏幕、单个窗口或单个标签页的内容。 用于定义 chooseDesktopMedia() 中使用的一组桌面媒体来源的枚举。 "screen" "window" "tab" "audio" 镜像 SelfCapturePreferenceEnum 。 "include" "exclude" 镜像 SystemAudioPreferenceEnum 。 "include" "exclude" 隐藏由 chooseDesktopMedia()
chrome.dns
Updated 2024年11月25日
使用 chrome.dns API 进行 DNS 解析。 如需使用此 API，您必须在 manifest 中声明 "dns" 权限。 以下代码调用 resolve() 以检索 example.com 的 IP 地址。 service-worker.js ： 字符串（选填） 表示 IP 地址字面量的字符串。仅当 resultCode 表示成功时才提供。 数值 结果代码。零表示成功。 解析给定的主机名或 IP 地址字面量。 字符串 要解析的主机名。 函数（可选） callback 参数如下所示：
chrome.declarativeContent
Updated 2024年11月25日
使用 chrome.declarativeContent API 可根据网页内容执行操作，而无需拥有读取网页内容的权限。 借助声明式内容 API，您可以根据网页的网址或 CSS 选择器是否与网页上的元素匹配来启用扩展程序的操作，而无需添加 主机权限 或注入 内容脚本 。 使用 activeTab 权限可在用户点击扩展程序的操作后与网页互动。 规则由条件和操作组成。如果满足其中任一条件，系统就会执行所有操作。相应操作分别为 setIcon() 和 showAction() 。
chrome.system.storage
Updated 2024年11月25日
使用 chrome.system.storage API 查询存储设备信息，并在可拆卸存储设备连接和断开连接时收到通知。 “success” 弹出命令已成功执行 - 应用可以提示用户移除设备。 "in_use" 设备正被其他应用使用。弹出操作未成功；在其他应用使用完设备之前，用户不应移除设备。 "no_such_device" 未知有此类设备。 “failure” 弹出命令失败。 数值 存储设备的可用容量（以字节为单位）。 字符串 getAvailableCapacity 函数参数 id 的复制
chrome.alarms
Updated 2024年11月25日
使用 chrome.alarms API 可安排代码定期运行或在未来的指定时间运行。 如需使用 chrome.alarms API，请在 manifest 中声明 "alarms" 权限： 为了确保可靠的行为，了解 API 的行为方式会很有帮助。 闹钟会在设备处于休眠状态时继续运行。不过，闹钟不会唤醒设备。设备唤醒后，所有错过的闹钟都会响铃。 重复闹钟最多会触发一次，然后系统会从设备唤醒时开始，使用指定的间隔时间重新安排闹钟，而不考虑闹钟最初设置为运行时已经经过的时间。
chrome.contextMenus
Updated 2024年11月25日
使用 chrome.contextMenus API 可向 Google Chrome 的上下文菜单添加项。您可以选择要将上下文菜单项应用于哪些类型的对象，例如图片、超链接和网页。 您必须在扩展程序的清单中声明 "contextMenus" 权限，才能使用该 API。此外，您还应指定一个 16 x 16 像素的图标，以便在菜单项旁边显示。例如： 上下文菜单项可显示在任何文档（或文档中的框架）中，即使是使用 file:// 或 chrome://
chrome.audio
Updated 2024年11月25日
chrome.audio API 的提供是为了让用户能够获取有关连接到系统的音频设备的信息并控制这些设备。此 API 目前仅适用于 ChromeOS 的自助服务终端模式。 字符串 设备名称。 DeviceType 设备类型。 字符串 简单易懂的名称（例如“USB 麦克风”）。 字符串 音频设备的唯一标识符。 布尔值 如果这是当前处于活动状态的设备，则为 true。 数值 设备的音量、输出音量、输入增益。 字符串（选填） 稳定/持久的设备 ID 字符串（如果有）。 StreamType
Autofill
Updated 2024年11月22日
浏览器和您作为开发者，都可以帮助用户更快地输入数据，并避免重复输入数据。 自动填充功能可让浏览器使用用户保存的信息（例如姓名、地址和付款详细信息）自动填充表单字段。了解自动填充功能的运作方式以及如何确保浏览器提供适当的自动填充选项，有助于用户节省大量时间和麻烦，并帮助他们避免出错。确保自动填充功能正常运行还有助于减少用户流失，从而提高表单提交率。 尤其是在商务和结账流程中，开发者发现自动填充功能对买方体验和商家成效有显著益处。 想要帮助用户快速轻松地从购物车进入付款流程？
chrome.declarativeNetRequest
Updated 2024年11月22日
chrome.declarativeNetRequest API 用于通过指定声明式规则来屏蔽或修改网络请求。这样，扩展程序就可以修改网络请求，而无需拦截和查看其内容，从而提供更高的隐私保护。 “ declarativeNetRequest ”和“ declarativeNetRequestWithHostAccess ”权限提供相同的功能。两者之间的区别在于请求或授予权限的时间。 除了前面介绍的权限之外，某些类型的规则集（尤其是静态规则集）还需要声明
chrome.devtools.panels
Updated 2024年11月22日
使用 chrome.devtools.panels API 将您的扩展程序集成到“开发者工具”窗口界面：创建自己的面板、访问现有面板以及添加边栏。 每个扩展程序面板和边栏都会显示为单独的 HTML 页面。“开发者工具”窗口中显示的所有扩展程序页面都可以访问 chrome.devtools API 的所有部分，以及所有其他扩展程序 API。 您可以使用 devtools.panels.setOpenResourceHandler
chrome.fileBrowserHandler
Updated 2024年11月22日
使用 chrome.fileBrowserHandler API 扩展 ChromeOS 文件浏览器。例如，您可以使用此 API 让用户将文件上传到您的网站。 当用户按 Alt+Shift+M 或连接外部存储设备（例如 SD 卡、USB 密钥、外部驱动器或数码相机）时，ChromeOS 文件浏览器就会弹出。除了显示外部设备上的文件外，文件浏览器还可以显示用户之前保存到系统中的文件。
chrome.readingList
Updated 2024年11月21日
使用 chrome.readingList API 读取和修改 阅读清单 中的项。 如需使用阅读列表 API，请在扩展程序 manifest 文件中添加 "readingList" 权限： manifest.json: Chrome 的侧边栏中提供了阅读清单。借助该功能，用户可以保存网页以供日后阅读或离线阅读。使用 Reading List API 检索现有内容，并在列表中添加或移除内容。 阅读列表中的项目没有固定的顺序。 项按网址键值对进行排序。其中包括哈希和查询字符串。 以下部分展示了
视频无障碍功能荣获 Gemini API 开发者大赛 Web 类奖项
Updated 2024年11月21日
我们已将 ViddyScribe 评选为 Gemini API 开发者大赛 Web 类奖项的获奖者。他们展示了 Gemini 如何通过为任何视频生成音频描述，帮助提高网页上视频的无障碍性。
chrome.networking.onc
Updated 2024年11月14日
chrome.networking.onc API 用于配置网络连接（移动网络、以太网、VPN 或 Wi-Fi）。此 API 适用于自动启动的 ChromeOS 自助服务终端会话。 网络连接配置是按照 Open Network Configuration (ONC) 规范指定的。 注意 ：大多数字典属性和枚举值使用 UpperCamelCase 命名法，以符合 ONC 规范，而不是使用 JavaScript 的 lowerCamelCase 惯例。 “已启用” “正在激活”
使用 Signal API 确保通行密钥与服务器上的凭据保持一致
Updated 2024年11月12日
借助 WebAuthn Signal API，依赖方可以向通行密钥提供程序发送现有凭据的状态信号，以便通行密钥与服务器上的凭据保持一致。
加入 Chrome 扩展程序 Prompt API 源试用
Updated 2024年11月12日
参与 Chrome 扩展程序 Prompt API 源试用，并在 Chrome 中使用 Gemini Nano。
WebGPU 的新变化 (Chrome 131)
Updated 2024年11月6日
WGSL 中的剪裁距离、GPUCanvasContext getConfiguration()、点和线基元不得有深度偏差、针对子组的包含扫描内置函数、对多绘制间接的实验性支持、着色器模块编译选项严格数学、移除 GPUAdapter requestAdapterInfo() 等。
通过无缝的凭据共享功能，帮助用户顺畅登录
Updated 2024年11月4日
借助无缝凭据共享功能，您可以安全地向密码管理工具发出信号，让用户能够在您的 Android 应用和网站中使用相同的凭据登录。
Chrome 开发者工具 (Chrome 131) 的新变化
Updated 2024年10月30日
使用 Gemini 调试 CSS，在“性能”面板中添加注释和获取数据洞见，发现过度布局偏移和非合成动画等问题。
从 Chrome 中移除 --headless=old
Updated 2024年10月23日
Chrome 132 不再包含旧版无头模式。迁移到 chrome-headless-shell 或新版无头模式。
为 Cache-Control: no-store 启用 bfcache
Updated 2024年10月21日
Chrome 将进行一项更改，允许在确保安全的情况下，对使用 Cache-Control: no-store 的网页使用 bfcache 功能。了解这对开发者意味着什么。
API 参考
Updated 2024年10月15日
针对 Chrome 扩展程序可用的所有 API 的完整参考。这包括适用于已弃用的 Chrome 应用平台的 API，以及仍在测试和开发阶段的 API。
Chrome 130
Updated 2024年10月15日
Chrome 130 现已发布！文档画中画功能可让您更好地控制画中画窗口，CSS 嵌套声明可修复一些棘手的边缘情况，您还可以指定分布在多行中的元素上的装饰的行为方式，还有更多功能！
Chrome 130 中的新变化
Updated 2024年10月15日
Chrome 130 现已发布！文档画中画可让您更好地控制画中画窗口，CSS 嵌套声明可修复一些棘手的边缘情况，您还可以指定分布在多行中的元素上的装饰的行为方式。Pete LePage 详细介绍了 Chrome 130 中面向开发者的新功能。
WebGPU（Chrome 130）中的新变化
Updated 2024年10月15日
双源混合、缩短了 Metal 的着色器编译时间、废弃了 GPUAdapter requestAdapterInfo() 等等。
chrome.virtualKeyboard
Updated 2024年10月14日
chrome.virtualKeyboard API 是仅限自助服务终端的 API，用于配置自助服务终端会话中虚拟键盘布局和行为。 布尔值（可选） 虚拟键盘能否提供自动补全功能。 布尔值（可选） 虚拟键盘能否提供自动更正功能。 布尔值（可选） 虚拟键盘是否可以通过手写识别来提供输入。 布尔值（可选） 虚拟键盘能否提供拼写检查功能。 布尔值（可选） 虚拟键盘是否可以提供语音输入。 设置对虚拟键盘提供的功能的限制。 FeatureRestrictions 启用/停用虚拟键盘功能的偏好设置。
chrome.clipboard
Updated 2024年10月14日
chrome.clipboard API 旨在允许用户访问剪贴板中的数据。这是针对 chromeos 平台应用的临时解决方案，直到开放网络替代方案推出为止。开放网络解决方案推出后（可能在 2017 年第 4 季度推出），它将弃用。 字符串 附加数据项的内容。如果 type 为“textPlain”，则为纯文本字符串或标记字符串（如果 type 为“textHTML”）。数据大小不得超过 2 MB。 DataItemType 其他数据项的类型。 "textPlain" "textHTML"
Long Animation Frames API
Updated 2024年10月14日
了解 Long Animation Frames API (LoAF)，该 API 是 Long Tasks API 的下一代迭代版本，支持通过归因衡量帧更新延迟
加入 Google Chrome 内置 AI 挑战赛
Updated 2024年10月1日
我们将举办内置 AI 挑战赛，诚邀您重新思考如何在 Chrome 中使用 Gemini Nano 实现各种可能。
Chrome 130 开发者工具的新变化
Updated 2024年9月30日
针对您可以在“效果”面板中浏览的实时指标和面包屑导航功能提供建议，改进了网络过滤条件，提供经过净化处理的 HAR 导出内容等。
提升 Chrome 应用商店开发者信息中心的移动体验
Updated 2024年9月30日
我们很高兴推出一组界面变更，使 Chrome 应用商店开发者信息中心的响应速度更快，更适合移动设备。我们希望这样能让您在监控商品详情效果、更改商品详情以及管理实体店内扩展程序时获得更便捷的体验。 我们更新了所有图表和分析页面，使其更具响应能力，以便您更好地查看扩展程序在移动设备上的商品详情效果。 您还可以通过移动设备更新商店元数据，包括说明、图片和隐私设置。
Web Vitals 扩展程序现已在 DevTools 中推出
Updated 2024年9月24日
Web Vitals 扩展程序将与 Chrome DevTools 的“性能”面板合并，并于 2025 年 1 月停用独立支持。
使用 Web 应用清单 ID 属性对 PWA 进行唯一标识
Updated 2024年9月20日
可选的 `id` 属性是 Web 应用清单规范的一部分，可让您明确定义用于 PWA 的标识符。向清单添加 `id` 属性会移除对 `start_url` 或清单位置的依赖，以便日后更新这些属性。
Chrome：用于在桌面设备和 Android 设备之间同步 Google 密码管理工具中的通行密钥
Updated 2024年9月19日
桌面版 Chrome 很快将能够在 Google 密码管理工具 (GPM) 中创建通行密钥，并在 Android 之外的其他平台上同步这些通行密钥。
在开发者工具中监控本地和真实用户的 Core Web Vitals 性能
Updated 2024年9月17日
Chrome 开发者工具中的“性能”面板提供了一种新的方式来监控本地 Core Web Vitals 性能，并将其与实际用户数据进行比较。
Chrome 129 中的新变化
Updated 2024年9月17日
Chrome 129 现已发布！长任务可以产生 - 为了提高性能，您可以为具有固有大小的元素添加动画效果，对锚点定位语法进行一些更改，等等。Pete LePage 详细介绍了 Chrome 129 中面向开发者的新功能。
键盘锁定 API 和 Pointer Lock API 需要从 Chrome 131 获得权限
Updated 2024年9月10日
借助 Keyboard Lock API ，开发者可以为各种用例（包括互动网站、游戏以及远程桌面或应用流式传输）提供沉浸式全屏体验。它通过允许网站使用主机操作系统允许的所有可用按键来实现此目的。 借助 Pointer Lock API ，桌面应用可以隐藏指针图标，并将鼠标移动解释为其他操作，例如在 3D 世界中环顾四周。 从 Chrome 131 开始，使用这两个 API 都需要权限。您可以 检查 权限，如以下代码段所示： 无需明确 请求
内存检查器：检查 ArrayBuffer、TypedArray、DataView 和 Wasm 内存。
Updated 2024年9月6日
使用内存检查器可在 JavaScript 以及 WebAssembly.Memory of C++ Wasm 应用中检查 ArrayBuffer、TypedArray 或 DataView。
隆重推出 Digital Credentials API 源试用
Updated 2024年9月4日
Digital Credentials API 的源试用将从 Chrome 128 开始。Digital Credentials API 是一种新的网络平台 API，可让网站通过数字凭据（例如存储在数字钱包中的驾照或国民身份证）选择性地请求有关用户的可验证信息。
在 Chrome 中实现跨网站无缝共享凭据的功能
Updated 2024年9月4日
如果您使用多个网域共用同一个账号管理后端，那么现在通过 Digital Asset Links，您还可以在这些网域之间无缝共享凭据。这样一来，用户只需保存一次凭据，即可让 Chrome 密码管理器将这些凭据推荐给任何关联的网站。
Chrome 129 开发者工具中的新功能
Updated 2024年9月2日
“效果”>“搜索请求”网络、通过自动填充功能在地址表单中使用测试数据、在“记录器”面板中导出到适用于 Firefox 的 Puppeteer，以及通过“性能”面板中的观察结果一目了然地发现性能问题，等等。
隆重推出适用于 Chrome 中的 WebAuthn 的提示、相关源请求和 JSON 序列化
Updated 2024年8月30日
Chrome 上的 WebAuthn 现在可以使用提示、相关源请求和 JSON 序列化
chrome.webRequest
Updated 2024年8月23日
使用 chrome.webRequest API 可观察和分析流量，以及拦截、阻止或修改传输中的请求。 您必须在 扩展程序清单 中声明 "webRequest" 权限，才能使用 Web 请求 API 以及必要的 主机权限 。要拦截子资源请求， 扩展程序必须同时有权访问请求的网址及其发起者。例如： webRequestBlocking 必须填写此字段，才能注册屏蔽事件处理脚本。从 Manifest V3 开始， 适用于通过政策安装的扩展程序 webRequestAuthProvider 使用
chrome.sidePanel
Updated 2024年8月23日
使用 chrome.sidePanel API 可将浏览器侧边栏中的内容与网页的主要内容一同托管。 如需使用 Side Panel API，请在扩展程序 清单 文件中添加 "sidePanel" 权限： manifest.json: 借助 Side Panel API，扩展程序可以在侧边栏中显示自己的界面，从而提供持久的体验，补充用户的浏览历程。 部分功能包括： 以下部分介绍了 Side Panel API 的一些常见用例。如需查看完整的扩展程序示例，请参阅 扩展程序示例 。 最初可通过清单的
chrome.omnibox
Updated 2024年8月23日
多功能框 API 可让您向 Chrome 浏览器的地址栏（也称为多功能框）注册关键字。 当该用户输入您扩展程序中的关键字后，便开始只与您的 。每次按键操作都会发送到您的扩展程序，并且您可以在响应中提供建议。 建议可以采用多种格式以各种格式进行显示。当用户接受建议后 您的扩展程序会收到通知，并可以采取相应措施。 您必须在 清单 中添加 omnibox keyword 字段，才能使用多功能框 API。您 还应该指定一个 16x16
chrome.pageAction
Updated 2024年8月23日
使用 chrome.pageAction API 将图标放置在 Google Chrome 主工具栏（地址栏右侧）中。网页操作是指可对当前网页执行，但并不适用于所有网页的操作。处于非活动状态的页面操作会显示为灰色。 一些示例： 以下屏幕截图中的 RSS 图标代表可让您订阅 RSS 的页面操作 Feed。 隐藏的网页操作会显示为灰色。例如，下面的 RSS Feed 是灰显的， 订阅当前页面的 Feed： 请考虑改用 浏览器操作 ，以便用户始终与您的 。 在 扩展程序清单
chrome.windows
Updated 2024年8月23日
使用 chrome.windows API 与浏览器窗口进行交互。您可以使用此 API 在浏览器中创建、修改和重新排列窗口。 收到请求时， windows.Window 会包含一组 tabs.Tab 对象。您必须 如果您需要访问 url ，请在 清单 中声明 "tabs" 权限， tabs.Tab 的 pendingUrl 、 title 或 favIconUrl 属性。例如： 扩展系统中的许多函数都接受可选的 windowId 参数，该参数默认为 。
chrome.i18n
Updated 2024年8月23日
使用 chrome.i18n 基础架构在您的整个应用或扩展程序中实现国际化。 您需要将其所有的用户可见字符串都放入名为 messages.json 的文件中。每次 添加新的语言区域时，请在名为 _locales/_localeCode_ 的目录下添加消息文件，其中 localeCode 是一个代码，例如表示英语的 en 。 以下是支持英语 ( en )、西班牙语的国际化扩展程序的文件层次结构 ( es ) 和韩语 ( ko )： 假设您的扩展程序包含如下图所示的文件：
chrome.browserAction
Updated 2024年8月23日
使用浏览器操作将图标放入 Google Chrome 主工具栏（位于地址栏的右侧）。除了 图标 之外，浏览器操作还可以包含 提示 、 标记 和 弹出式窗口 。 在下图中，地址栏右侧的彩色方块是 。图标下方会显示一个弹出式窗口。 如果您想创建的图标不是始终处于活跃状态，请使用 网页操作 （而不是浏览器） 操作。 在 扩展程序清单 中注册浏览器操作，如下所示： 您可以提供任意尺寸的图标，以便在 Chrome 中使用，Chrome 会选择最接近的图标并进行缩放 将其调整为适当的尺寸，以填充
chrome.webRequest
Updated 2024年8月23日
使用 chrome.webRequest API 可观察和分析流量，以及拦截、阻止或修改传输中的请求。 您必须在 扩展程序清单 中声明 "webRequest" 权限，才能使用 Web 请求 API 以及必要的 主机权限 。要拦截子资源请求， 扩展程序必须同时有权访问请求的网址及其发起者。例如： 从 Chrome 108 开始，如果您使用 "webRequest" 和 "webRequestAuthProvider" ，则可以为 onAuthRequired 事件 异步提供凭据 权限。 Web
chrome.fileBrowserHandler
Updated 2024年8月23日
使用 chrome.fileBrowserHandler API 扩展 Chrome 操作系统的文件浏览器。例如，您可以使用此 API 让用户向您的网站上传文件。 当用户按 Alt+Shift+M 或连接外部存储设备（例如 SD 卡、USB 密钥、外部驱动器或数码相机）时，ChromeOS 文件浏览器将会启动。除了显示外部设备上的文件外，文件浏览器还可以显示用户之前保存到系统的文件。
chrome.devtools.panels
Updated 2024年8月23日
使用 chrome.devtools.panels API 将您的扩展程序集成到开发者工具窗口界面中：创建自己的面板、访问现有面板以及添加边栏。 必须在 清单 中声明以下键才能使用此 API。 有关使用开发者工具 API 的一般说明，请参阅 DevTools API 摘要 。 每个扩展程序面板和边栏都会显示为一个单独的 HTML 网页。已显示所有扩展程序页面 在“开发者工具”窗口中可以访问 chrome.devtools API 中的所有模块，以及 chrome.extension
chrome.system.cpu
Updated 2024年8月23日
使用 system.cpu API 查询 CPU 元数据。 字符串 处理器的架构名称。 字符串[] 一组功能代码，用于表示处理器的部分功能。目前支持的代码包括“mmx”“sse”“sse2”“sse3”“ssse3”“sse4_1”“sse4_2”和“avx”。 字符串 处理器的型号名称。 number 逻辑处理器数量。 ProcessorInfo [] 每个逻辑处理器的相关信息。 数值 [] 来自 CPU 每个热区的 CPU 温度读数列表。温度以摄氏度为单位。 目前仅适用于 ChromeOS。
chrome.enterprise.networkingAttributes
Updated 2024年8月23日
使用 chrome.enterprise.networkingAttributes API 读取有关当前网络的信息。注意：此 API 仅适用于由企业政策强制安装的扩展程序。 字符串（可选） 设备的本地 IPv4 地址（如果未配置，则未定义）。 字符串（可选） 设备的本地 IPv6 地址（如果未配置，则未定义）。 字符串 设备的 MAC 地址。 检索设备默认网络的网络详细信息。如果用户未关联或设备未连接到网络，系统将设置 runtime.lastError 并注明失败原因。 函数（可选）
chrome.input.ime
Updated 2024年8月23日
使用 chrome.input.ime API 为 ChromeOS 实现自定义 IME。这样一来，您的扩展程序就可以处理按键、设置构图和管理候选窗口。 您必须声明“input”权限，以使用 input.ime API。 例如： 以下代码会创建一个 IME，用于将输入的字母转换为大写。 辅助窗口中按钮的 ID。 "撤消" "addToDictionary" 辅助窗口的属性。 字符串（可选） ChromeVox 朗读的字符串。 "撤消" 布尔值 设为 true 以显示
chrome.instanceID
Updated 2024年8月23日
使用 chrome.instanceID 访问实例 ID 服务。 重置应用实例标识符并撤消与其关联的所有令牌。 函数（可选） callback 参数如下所示： 承诺<void> 只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。 撤消已授予的令牌。 对象 deleteToken 的参数。 字符串 用于获取令牌的授权实体。 字符串 用于获取令牌的范围。 函数（可选） callback 参数如下所示： 承诺<void> 只有 Manifest
chrome.gcm
Updated 2024年8月23日
使用 chrome.gcm 可让应用和扩展程序通过 Firebase Cloud Messaging (FCM) 发送和接收消息。 消息中所有键值对的大小上限（以字节为单位）。 4096 向 FCM 注册该应用。 callback 将返回注册 ID。如果使用同一 senderIds 列表再次调用 register ，则会返回相同的注册 ID。 字符串[] 允许向应用发送消息的服务器 ID 列表。其中应包含至少 1 个发送者 ID，但不得超过 100 个。 函数（可选） callback
chrome.loginState
Updated 2024年8月23日
使用 chrome.loginState API 读取和监控登录状态。 "SIGNIN_PROFILE" 指定扩展程序在登录个人资料中。 "USER_PROFILE" 指定扩展程序在用户个人资料中。 "UNKNOWN" 指定会话状态未知。 "IN_OOBE_SCREEN" 指定用户处于开箱体验屏幕。 "IN_LOGIN_SCREEN" 指定用户正处于登录屏幕。 "IN_SESSION" 指定用户正在会话中。 "IN_LOCK_SCREEN" 指定用户位于锁定屏幕中。
chrome.fontSettings
Updated 2024年8月23日
使用 chrome.fontSettings API 管理 Chrome 的字体设置。 要使用 Font Settings API，您必须声明“fontSettings”权限 清单 。例如： Chrome 允许某些字体设置取决于特定的常规字体系列和语言 脚本。例如， sans-serif 简体中文使用的字体可能与该字体不同 用于 serif 日语。 Chrome 支持的通用字体系列基于 CSS 通用字体系列 ， 。如果网页指定了通用字体系列，Chrome
chrome.printingMetrics
Updated 2024年8月23日
使用 chrome.printingMetrics API 提取有关打印使用情况的数据。 "BLACK_AND_WHITE" 指定使用黑白模式。 "COLOR" 指定使用了颜色模式。 "ONE_SIDED" 指定使用单面打印。 &quot;TWO_SIDED_LONG_EDGE&quot; 指定使用双面打印，将长边翻转。 &quot;TWO_SIDED_SHORT_EDGE&quot; 指定使用双面打印，短边翻转。 number 打印介质的高度（以微米为单位）。
chrome.processes
Updated 2024年8月23日
使用 chrome.processes API 与浏览器的进程进行交互。 number 使用的缓存部分（以字节为单位）。 number 缓存的大小（以字节为单位）。 编号（ 选填 ） 最近测量的进程 CPU 使用率，表示为进程的所有线程使用的单个 CPU 核心所占的百分比。这会得到一个介于 0 到 CpuInfo.numOfProcessors*100 之间的值，在多线程进程中，该值可以超过 100%。仅当作为 onUpdated 或 onUpdatedWithMemory
chrome.platformKeys
Updated 2024年8月23日
使用 chrome.platformKeys API 访问由平台管理的客户端证书。如果用户或政策授予了此权限，扩展程序便可在其自定义身份验证协议中使用此类证书。例如：这允许在第三方 VPN 中使用平台管理的证书（请参阅 chrome.vpnProvider ）。 ArrayBuffer[] 服务器允许的证书授权机构的标识名列表。每个条目都必须是 DER 编码的 X.509 DistinguishedName。 ClientCertificateType []
chrome.devtools.inspectedWindow
Updated 2024年8月23日
使用 chrome.devtools.inspectedWindow API 与检查的窗口进行交互：获取被检查页面的标签页 ID、在被检查的窗口中评估代码、重新加载页面或者获取页面中的资源列表。 必须在 清单 中声明以下键才能使用此 API。 使用 chrome.devtools.inspectedWindow 与检查的窗口进行交互：获取用于 在检查窗口中评估代码、重新加载页面或获取 该页面内的资源列表。 有关使用开发者工具 API 的一般说明，请参阅 DevTools API 摘要 。
chrome.history
Updated 2024年8月23日
使用 chrome.history API 与浏览器的已访问网页的记录进行交互。您可以在浏览器的历史记录中添加、移除和查询网址。如需使用您自己的版本替换历史记录页面，请参阅 覆盖网页 。 您必须声明“历史记录”权限，以便使用 History API。 例如： History API 使用 过渡类型 来描述浏览器如何导航到特定网址 。例如，如果用户通过点击其他网页上的链接访问了某个网页， 为“link” 下表介绍了每种过渡类型。 若要试用此 API，请安装
chrome.identity
Updated 2024年8月23日
使用 chrome.identity API 获取 OAuth2 访问令牌。 字符串 账号的唯一标识符。在账号的整个有效期内，此 ID 不会发生变化。 "SYNC" 指定为主账号启用同步功能。 "ANY" 指定是否存在主账号（如果有）。 string[] 选填 向扩展程序授予的 OAuth2 范围列表。 字符串（可选） 与请求关联的特定令牌。 字符串 应从缓存中移除的特定令牌。 AccountStatus 可选 登录到个人资料的主账号的状态，该个人资料的 ProfileUserInfo
chrome.tts
Updated 2024年8月23日
使用 chrome.tts API 播放合成的文字转语音 (TTS)。另请参阅相关的 ttsEngine API，该 API 允许扩展程序实现语音引擎。 Chrome 为 Windows（使用 SAPI 5）、Mac OS X 和 ChromeOS 上的语音提供原生支持，使用 语音合成功能。在所有平台上，用户都可以 安装会自行注册为备用语音引擎的扩展程序。 通过分机拨打 speak() 开始说话。例如： 要立即停止说话，只需调用 stop() 即可：
chrome.devtools.recorder
Updated 2024年8月23日
使用 chrome.devtools.recorder API 自定义开发者工具中的“Recorder”面板。 有关使用开发者工具 API 的一般说明，请参阅 DevTools API 摘要 。 devtools.recorder API 是一项预览版功能，可让您扩展 Chrome 开发者工具中的 Recorder 面板 。 从 Chrome M105 开始，您可以扩展导出功能。从 Chrome M112 开始，您可以延长重放按钮。 如需注册扩展插件，请使用
chrome.enterprise.hardwarePlatform
Updated 2024年8月23日
使用 chrome.enterprise.hardwarePlatform API 获取运行浏览器的硬件平台的制造商和型号。注意：此 API 仅适用于由企业政策安装的扩展程序。 字符串 字符串 获取硬件平台的制造商和型号，如果扩展程序获得授权，则会通过 callback 返回。 函数（可选） callback 参数如下所示： HardwarePlatformInfo Promise&lt; HardwarePlatformInfo &gt; 只有 Manifest V3
chrome.dom
Updated 2024年8月23日
使用 chrome.dom API 访问适用于扩展程序的特殊 DOM API 获取由指定元素托管的打开的影子根或封闭的影子根。如果该元素未附加影子根，它将返回 null。 HTMLElement 对象 请参阅 https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot
chrome.tabCapture
Updated 2024年8月23日
使用 chrome.tabCapture API 与标签页媒体流进行交互。 借助 chrome.tabCapture API，您可以访问包含视频和媒体内容的 MediaStream 。 当前标签页的音频。只有在用户调用扩展程序后才能调用该方法，例如通过 该扩展程序的 操作按钮 即可。这类似于 activeTab 权限。 为某个标签页获取 MediaStream 后，该标签页中的音频将不再播放 。这与 getDisplayMedia() 函数在以下情况的行为类似：
chrome.management
Updated 2024年8月23日
chrome.management API 提供了多种方法来管理已安装的应用和扩展程序。 您必须声明“management” 扩展程序清单 中的权限，以使用管理功能 API。例如： management.getPermissionWarningsByManifest 、 management.uninstallSelf 和 management.getSelf 无需管理权限。 该项被停用的原因。 “未知” &quot;permissions_increase&quot;
chrome.webNavigation
Updated 2024年8月23日
使用 chrome.webNavigation API 接收有关飞行中导航请求状态的通知。 所有 chrome.webNavigation 方法和事件都需要您声明“webNavigation”权限 在 扩展程序清单 中。例如： 对于成功完成的导航，系统会按以下顺序触发事件： 此过程过程中发生的任何错误都会导致 onErrorOccurred 事件。对于特定的 导航时，在 onErrorOccurred 后不再触发其他事件。 如果导航帧包含子帧，其 onCommitted
chrome.topSites
Updated 2024年8月23日
使用 chrome.topSites API 访问新标签页上显示的热门网站（即最常访问的网站）。这些不包括用户自定义的快捷方式。 您必须声明“topSites” 扩展程序清单 中授予使用此 API 的权限。 若要试用此 API，请安装 chrome-extension-samples 中的 topSites API 示例 存储库 用于封装最常访问的网址（例如新标签页上的默认快捷方式）的对象。 字符串 网页的标题 字符串 最常访问的网址。 获取热门网站列表。 函数（可选） callback
chrome.windows
Updated 2024年8月23日
使用 chrome.windows API 与浏览器窗口进行交互。您可以使用此 API 在浏览器中创建、修改和重新排列窗口。 收到请求时， windows.Window 会包含一组 tabs.Tab 对象。您必须 如果您需要访问 url ，请在 清单 中声明 "tabs" 权限， tabs.Tab 的 pendingUrl 、 title 或 favIconUrl 属性。例如： 扩展系统中的许多函数都接受可选的 windowId 参数，该参数默认为 。
chrome.search
Updated 2024年8月23日
使用 chrome.search API 通过默认提供程序进行搜索。 "CURRENT_TAB" 指定搜索结果显示在发起调用的标签页中或当前所用浏览器的标签页中。 "NEW_TAB" 指定搜索结果显示在新标签页中。 "NEW_WINDOW" 指定搜索结果在新窗口中打开。 Disposition （可选） 应显示搜索结果的位置。默认为 CURRENT_TAB 。 编号（ 选填 ） 应显示搜索结果的位置。 tabId 不能与 disposition 一起使用。 字符串
chrome.idle
Updated 2024年8月23日
使用 chrome.idle API 检测机器的空闲状态何时发生变化。 你必须声明“idle”权限，以使用闲置 API。例如： "有效" "idle" "已锁定" 获取屏幕在闲置时自动锁定所用的时间（以秒为单位）。如果屏幕从不自动锁定，则返回时长为零。目前仅适用于 ChromeOS。 函数（可选） callback 参数如下所示： number 屏幕在闲置时自动锁定所用的时间（以秒为单位）。如果屏幕永不自动锁定，则此值为零。 Promise&lt;number&gt; 只有
chrome.types
Updated 2024年8月23日
chrome.types API 包含 Chrome 的类型声明。 ChromeSetting 原型提供了一组常用的函数（ get() 、 set() 和 clear() ） 以及 Chrome 浏览器设置的事件发布者 ( onChange )。 代理设置 示例 演示了这些函数的预期用途。 Chrome 可区分浏览器设置的三种不同范围： Chrome 管理不同图层上的设置。以下列表介绍了可 影响有效设置（按优先顺序由高到低）。
chrome.wallpaper
Updated 2024年8月23日
使用 chrome.wallpaper API 更改 ChromeOS 壁纸。 您必须声明“壁纸”权限，以便使用 壁纸 API。例如： 例如，要将壁纸设为 https://example.com/a_file.png ，你可以拨打 chrome.wallpaper.setWallpaper 。 支持的壁纸版式。 “STRETCH” "CENTER" "CENTER_CROPPED" 将壁纸设置为位于 url 或 wallpaperData 且具有指定的 layout 的图片 对象
chrome.enterprise.deviceAttributes
Updated 2024年8月23日
使用 chrome.enterprise.deviceAttributes API 读取设备属性。注意：此 API 仅适用于由企业政策强制安装的扩展程序。 获取管理员注释的营业地点。如果当前用户未关联或管理员未设置任何注释位置，则返回空字符串。 函数（可选） callback 参数如下所示： 字符串 承诺<字符串> 只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。 获取管理员注释的资产 ID。如果当前用户未关联或管理员尚未设置资产
chrome.privacy
Updated 2024年8月23日
您可以使用 chrome.privacy API 控制 Chrome 中可能会影响用户隐私的功能的使用情况。此 API 依赖 ChromeSetting 类型 API 的原型 来获取和设置 Chrome 的配置。 您必须声明“隐私”权限，才能使用该 API。 例如： 读取 Chrome 设置的当前值非常简单。您首先需要找到 属性，那么您将需要对该对象调用 get() ，以检索其 当前值以及您的扩展程序的控制级别。例如，确定 Chrome 的自动填充功能是否 您需要编写：
chrome.systemLog
Updated 2024年8月23日
使用 chrome.systemLog API 记录扩展程序中的 Chrome 系统日志。 字符串 添加新的日志记录。 MessageOptions 日志记录选项。 函数（可选） callback 参数如下所示： 承诺<void> 只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
chrome.pageCapture
Updated 2024年8月23日
使用 chrome.pageCapture API 可将标签页保存为 MHTML。 MHTML 是大多数浏览器支持的 标准格式 。它将页面封装在单个文件中 及其所有资源（CSS 文件、图片...） 请注意，出于安全考虑，MHTML 文件只能从文件系统加载，而且 只能在主框架中加载 您必须声明“pageCapture”权限，以使用 pageCapture API。例如： 将具有指定 ID 的标签页的内容保存为 MHTML。 对象 number 要另存为 MHTML 的标签页的 ID。 函数（可选）
chrome.fileSystemProvider
Updated 2024年8月23日
您可以使用 chrome.fileSystemProvider API 创建可通过 Chrome 操作系统的文件管理器访问的文件系统。 您必须声明“fileSystemProvider”权限和 扩展程序清单 中的部分，以便使用 File System Provider API。例如： file_system_provider 部分必须声明如下： “文件”应用使用上述信息来适当呈现相关的界面元素。例如，如果 configurable 设置为 true，则系统会呈现用于配置卷的菜单项。同样，如果
chrome.notifications
Updated 2024年8月23日
借助 chrome.notifications API，您可以使用模板创建内容丰富的通知，并在系统任务栏中向用户显示这些通知。 字符串（可选） 按钮图标对 Mac OS X 用户不可见。 字符串 字符串 关于此内容的其他详细信息。 字符串 列表通知中一项的标题。 字符串（可选） Mac OS X 用户看不到应用图标遮罩。 指向应用图标遮罩的网址。网址与 iconUrl 具有相同的限制。 应用图标遮罩应采用 alpha 通道，因为系统只会考虑图片的 alpha 通道。
chrome.power
Updated 2024年8月23日
使用 chrome.power API 替换系统的电源管理功能。 默认情况下，当用户不活动时，操作系统会调暗屏幕，并最终暂停 系统。借助 Power API，应用或扩展程序可使系统保持唤醒状态。 使用此 API，您可以指定要停用电源管理的 Level 。 "system" 使系统保持活动状态，但允许调暗或关闭屏幕。例如， 通信应用在屏幕关闭时继续接收消息。 "display" 级别 使屏幕和系统保持活动状态例如，电子书和演示文稿应用 和系统处于活动状态。
chrome.downloads
Updated 2024年8月23日
此权限 会触发警告 使用 chrome.downloads API 以编程方式启动、监控、操作和搜索下载内容。 您必须在 扩展程序清单 中声明 "downloads" 权限，才能使用此 API。 您可以在 examples/api/downloads 中找到使用 chrome.downloads API 的简单示例 目录。如需获取其他示例以及查看源代码方面的帮助，请参阅 示例 。 布尔值（可选） 布尔值（可选） 文件 下载内容的文件名可疑。 网址 已知下载内容的网址是恶意网址。 内容
chrome.devtools.network
Updated 2024年8月23日
使用 chrome.devtools.network API 检索由开发者工具在“Network”面板中显示的网络请求的相关信息。 必须在 清单 中声明以下键才能使用此 API。 有关使用开发者工具 API 的一般说明，请参阅 DevTools API 摘要 。 网络请求信息以 HTTP 归档格式 ( HAR ) 表示。以下各项的说明： HAR 不在本文档的介绍范围内，请参阅 HAR v1.2 规范 。 对于 HAR， chrome.devtools.network.getHAR()
chrome.vpnProvider
Updated 2024年8月23日
使用 chrome.vpnProvider API 实现 VPN 客户端。 vpnProvider 的典型用法如下： 使用 createConfig 方法创建 VPN 配置。VPN 配置是在原生 ChromeOS 界面中向用户显示的永久条目。用户可以从列表中选择 VPN 配置，然后连接到该配置或断开该配置。 为 onPlatformMessage 、 onPacketReceived 和 onConfigRemoved 事件添加监听器。 当用户连接到 VPN 配置时，会收到
chrome.proxy
Updated 2024年8月23日
使用 chrome.proxy API 管理 Chrome 的代理设置。此 API 依赖 ChromeSetting 类型 API 原型 来获取和设置代理配置。 您必须声明“代理”权限，以使用代理设置 API。例如： 代理设置在 proxy.ProxyConfig 对象中定义。根据 Chrome 的代理设置， 这些设置可能包含 proxy.ProxyRules 或 proxy.PacScript 。 ProxyConfig 对象的 mode 属性决定了 Chrome
chrome.printerProvider
Updated 2024年8月23日
chrome.printerProvider API 公开了打印管理器用于查询由扩展程序控制的打印机、查询其功能以及向这些打印机提交打印作业的事件。 字符串（可选） 打印机的直观易懂的说明。 字符串 唯一打印机 ID。 字符串 打印机的人类可读名称。 为响应 onPrintRequested 事件而返回的错误代码。 "OK" 表示操作已成功完成。 "FAILED" 表示发生了常规故障。 "INVALID_TICKET"
chrome.events
Updated 2024年8月23日
chrome.events 命名空间包含一些常用类型，API 会使用这些类型来调度事件，以便在发生值得注意的事情时通知您。 Event 是一个对象，可让您在发生有趣的事情时收到通知。这里有 使用 chrome.alarms.onAlarm 事件在闹钟经过时接收通知的示例： 如示例所示，您将使用 addListener() 注册接收通知。用于 addListener() 始终是您定义的用于处理事件的函数， 函数取决于您正在处理的事件。查看 alarms.onAlarm
chrome.events
Updated 2024年8月22日
chrome.events 命名空间包含一些常用类型，API 会使用这些类型来调度事件，以便在发生值得注意的事情时通知您。 Event 是一个对象，可让您在发生有趣的事情时收到通知。这里有 使用 chrome.alarms.onAlarm 事件在闹钟经过时接收通知的示例： 如示例所示，您将使用 addListener() 注册接收通知。用于 addListener() 始终是您定义的用于处理事件的函数， 函数取决于您正在处理的事件。查看 alarms.onAlarm
chrome.dom
Updated 2024年8月22日
使用 chrome.dom API 访问适用于扩展程序的特殊 DOM API 获取由指定元素托管的打开的影子根或封闭的影子根。如果该元素未附加影子根，它将返回 null。 HTMLElement 对象 请参阅 https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot
chrome.omnibox
Updated 2024年8月22日
多功能框 API 可让您向 Chrome 浏览器的地址栏（也称为多功能框）注册关键字。 当该用户输入您扩展程序中的关键字后，便开始只与您的 。每次按键操作都会发送到您的扩展程序，并且您可以在响应中提供建议。 建议可以采用多种格式以各种格式进行显示。当用户接受建议后 您的扩展程序会收到通知，并可以采取相应措施。 必须在 清单 中声明以下键才能使用此 API。 您必须在 清单 中添加 "omnibox.keyword" 字段，才能使用多功能框 API。您 还应该指定一个 16 x 16
chrome.sockets.tcp
Updated 2024年8月22日
使用 chrome.sockets.tcp API，通过 TCP 连接通过网络发送和接收数据。此 API 会取代之前在 chrome.socket API 中提供的 TCP 功能。 必须在 清单 中声明以下键才能使用此 API。 number 新创建的套接字的 ID。请注意，通过此 API 创建的套接字 ID 与其他 API（例如已弃用的 [ socket ](../socket/) API）创建的套接字 ID 不兼容。 DNS 解析偏好设置。默认值为 any ，并使用可能返回 IPv4 或
chrome.sockets.tcpServer
Updated 2024年8月22日
借助 chrome.sockets.tcpServer API，您可以创建使用 TCP 连接的服务器应用。此 API 会取代之前在 chrome.socket API 中提供的 TCP 功能。 必须在 清单 中声明以下键才能使用此 API。 number 从底层网络调用返回的结果代码。 number 服务器套接字标识符。 number 客户端套接字标识符，即新建立的连接的套接字标识符。此套接字标识符只能与 chrome.sockets.tcp
chrome.app.window
Updated 2024年8月22日
使用 chrome.app.window API 创建窗口。Windows 有一个带有标题栏和大小控件的可选框架。而不会与任何 Chrome 浏览器窗口关联。如需查看这些选项的演示，请参阅 窗口状态示例 。 窗口 JavaScript“窗口”对象。 字符串 创建窗口时所用的 ID。 边界 窗口内容（不包括窗口装饰）的位置、大小和约束条件。这是 Chrome 36 中的新属性。 边界 窗口的位置、大小和约束条件，包括标题栏和框架等窗口装饰。这是 Chrome 36 中的新属性。 void
日志记录
Updated 2024年8月22日
默认情况下，ChromeDriver 只会将警告/错误记录到 stderr 中。调试时 启用更详细的日志记录会很有帮助。 若要启用详细日志记录功能，只需将 --verbose 传递给 chromedriver 服务器即可。 您也可以传递 --log-path ，使日志改为写入文件 错误。如果您没有直接自行启动 chromedriver 服务器， 需要通过 WebDriver 客户端库传递开关。有些客户端不 但很抱歉 将 --log-path 传递给 Chrome 启动命令时，Chrome
ChromeDriver 使用入门
Updated 2024年8月22日
本页记录了如何开始使用 ChromeDriver 来测试您的网站： 桌面 (Windows/Mac/Linux)。您还可以阅读 Android 使用入门 或 ChromeOS 使用入门 。 ChromeDriver 是 Selenium WebDriver 用于控制 Chrome 的独立可执行文件。此扩展程序由 Chromium 团队在 WebDriver 贡献者的帮助下进行维护。如果您不熟悉 Selenium WebDriver，则应访问 Selenium 网站 。
Chrome 扩展程序
Updated 2024年8月22日
您可以打包 Chrome 扩展程序，也可以将其解包。 要打包已解压的扩展程序，请使用 chrome://extensions 中的“打包”按钮，或 请使用 Chrome: "chrome.exe --pack-extension=C:\path\to\unpacked\extension --pack-extension-key=C:\myext.pem" 。如需解压缩打包的扩展程序，请按以下步骤操作： 提取文件。您可能需要将该文件的文件类型从.crx 重命名为.zip ， zip
chrome.browsingData
Updated 2024年8月22日
使用 chrome.browsingData API 从用户的本地个人资料中移除浏览数据。 您必须在 扩展程序清单 中声明 "browsingData" 权限，才能使用此 API。 此 API 最简单的用例是一种基于时间的机制，用于清除用户浏览数据。 您的代码应提供一个时间戳，指明历史日期，在此日期之后 浏览数据。此时间戳的格式设置为自事件发生以来经过的毫秒数 Unix 纪元（可以使用 getTime() 方法从 JavaScript Date 对象中检索）。
chrome.system.memory
Updated 2024年8月22日
chrome.system.memory API。 number 可用容量的量（以字节为单位）。 number 物理内存容量的总容量（以字节为单位）。 获取物理内存信息。 函数（可选） callback 参数如下所示： MemoryInfo Promise&lt; MemoryInfo &gt; 只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
chrome.dns
Updated 2024年8月21日
使用 chrome.dns API 进行 DNS 解析。 如需使用此 API，您必须在 清单 中声明 "dns" 权限。 以下代码会调用 resolve() 来检索 example.com 的 IP 地址。 service-worker.js ： 字符串（可选） 表示 IP 地址字面量的字符串。仅当 resultCode 指示成功时才提供。 number 结果代码。零表示成功。 解析给定的主机名或 IP 地址字面量。 字符串 要解析的主机名。 函数（可选） callback 参数如下所示：
Chrome 128 中的新功能
Updated 2024年8月20日
Chrome 128 现已推出！通过使用换行符改进红宝石元素的显示，Promise.try 来更轻松地启动 Promise 链，通过扩展 PointerEvent 接口来唯一地标识多种笔，等等。Adriana Jara 详细介绍了 Chrome 128 中面向开发者的新功能。
Chrome 128
Updated 2024年8月20日
Chrome 128 将于 2024 年 8 月 20 日开始逐步推出，包含 CSS ruby-align 属性 Promise.try 以及更多内容。
WebGPU 的新变化 (Chrome 128)
Updated 2024年8月20日
使用子群组进行实验，弃用线和点的深度偏差设置，隐藏未捕获的错误开发者工具警告（如果 preventDefault），先进行 WGSL 插值采样，然后执行上述任一操作。
File System Observer API 源试用
Updated 2024年8月20日
Chrome 团队正在对新的 File System Observer API 进行实验，该 API 可将文件系统发生的变化告知开发者。
提升了 Chromium 无障碍功能的性能
Updated 2024年8月20日
Ahmed Elwasefi 的一篇帖子，分享了他是如何通过 Google 夏季编程活动成为 Chromium 贡献者的。
chrome.alarms
Updated 2024年8月20日
使用 chrome.alarms API 安排代码定期运行或在未来的指定时间运行。 如需使用 chrome.alarms API，请在 清单 中声明 "alarms" 权限： 以下示例展示了如何使用和响应闹钟。如需试用此 API， 安装 chrome-extension-samples 中的 chrome-extension-samples 存储库 以下示例会在安装扩展程序时在 Service Worker 中设置警报： service-worker.js ： 以下示例根据已响铃闹钟的名称设置
chrome.contextMenus
Updated 2024年8月20日
使用 chrome.contextMenus API 向 Google Chrome 的上下文菜单中添加项。您可以选择从右键菜单中添加的对象类型，例如图片、超链接和页面。 上下文菜单项可以出现在任何文档（或文档中的框架）中，甚至是那些带有 file:// 的菜单项 或 chrome:// 网址。要控制您的内容可以显示在哪些文档中，请指定 documentUrlPatterns 字段。 create() update() 您可以根据需要创建任意数量的上下文菜单项，但如果扩展程序中的多个菜单项 则
chrome.audio
Updated 2024年8月20日
通过提供 chrome.audio API，用户可以获取有关系统连接到的音频设备的信息并控制该设备。此 API 目前只能在适用于 ChromeOS 的自助服务终端模式下使用。 字符串 设备名称。 DeviceType 设备类型。 字符串 简单易懂的名称（例如“USB 麦克风”）。 字符串 音频设备的唯一标识符。 布尔值 如果这是当前活跃设备，则为 true。 number 设备的音量、输出的音量、输入的增益。 字符串（可选） 稳定/持久保留的设备 ID 字符串（如果有）。 StreamType
chrome.commands
Updated 2024年8月20日
您可以使用 Command API 添加可在扩展程序中触发操作的键盘快捷键，例如，用于打开浏览器操作或向扩展程序发送命令的操作。 必须在 清单 中声明以下键才能使用此 API。 Commands API 允许扩展程序开发者定义特定命令，并将它们绑定到默认命令 组合键。扩展程序接受的每个命令都必须声明为 "commands" 对象。 属性键用作命令的名称。命令对象可以采用两个属性。 可选属性，用于声明命令的默认键盘快捷键。如果省略， 命令就会解除绑定此属性可以采用字符串或对象值。 字符串值
chrome.debugger
Updated 2024年8月20日
chrome.debugger API 可用作 Chrome 远程调试协议 的替代传输服务。使用 chrome.debugger 附加到一个或多个标签页，以便对网络交互进行插桩、调试 JavaScript、转变 DOM 和 CSS 等。使用 Debuggee 属性 tabId 可定位具有 sendCommand 的标签页，并通过 tabId 从 onEvent 回调对事件进行路由。 出于安全考虑， chrome.debugger API 不提供对所有 Chrome
chrome.declarativeContent
Updated 2024年8月20日
使用 chrome.declarativeContent API 可根据网页内容执行操作，而无需读取网页内容的权限。 声明式 Content API 可让您根据 或者 CSS 选择器与页面上的某个元素匹配，无需 添加 主机权限 或注入 内容脚本 。 使用 activeTab 权限，以在用户点击 操作。 规则由条件和操作组成。如果满足任一条件，则所有操作 。这些操作包括 setIcon 和 showAction 。 当且仅当所有网页都列出时， PageStateMatcher
chrome.declarativeNetRequest
Updated 2024年8月20日
chrome.declarativeNetRequest API 用于通过指定声明式规则来屏蔽或修改网络请求。这样一来，扩展程序就能够修改网络请求，而不会拦截这类请求并查看其中的内容，从而更好地保护用户隐私。 declarativeNetRequestFeedback host_permissions 除了上述权限之外，某些类型的规则集（具体来说是静态规则集）还要求声明 "declarative_net_request" 清单键，该清单键应该是具有一个名为 "rule_resources"
chrome.browsingData
Updated 2024年8月20日
使用 chrome.browsingData API 从用户的本地个人资料中移除浏览数据。 您必须声明“browsingData”权限，才能使用此 API。 此 API 最简单的用例是一种基于时间的机制，用于清除用户浏览数据。 您的代码应提供一个时间戳，指明历史日期，在此日期之后 浏览数据。此时间戳的格式设置为自事件发生以来经过的毫秒数 Unix 纪元（可通过 getTime 方法从 JavaScript Date 对象中检索）。 例如，要清除用户上周的所有浏览数据，您可以编写如下代码： 如下：
File System Access API：简化对本地文件的访问
Updated 2024年8月19日
借助 File System Access API，开发者可以构建功能强大的 Web 应用，与用户本地设备上的文件进行交互，例如 IDE、照片和视频编辑器、文本编辑器等。用户向 Web 应用授予访问权限后，此 API 可让用户直接读取或保存对用户设备上的文件和文件夹所做的更改。
WebDriver BiDi 可在 Firefox、Chrome 和 Puppeteer 中正式投入使用
Updated 2024年8月7日
Puppeteer 23 引入了对 Firefox 129 及更高版本的稳定支持，根据 WebDriver BiDi 为 Chrome 和 Firefox 自动化功能提供统一的 API。
Android 版 Chrome 中的通行密钥用户体验更新
Updated 2024年8月5日
Android 版 Chrome 现在集成了 Credential Manager，可让第三方密码管理工具在 Android 14 及更高版本上提供通行密钥
现在可在 BrowserStack 上通过 WebDriver BiDi 实现自动化
Updated 2024年8月1日
BrowserStack 引入 WebDriver BiDi 支持：通过事件驱动型自动化增强 Selenium 网格测试。
Chrome 127 中的新功能
Updated 2024年7月23日
Chrome 127 现已推出！借助对 font-size-adjust 的支持，Document Picture-in-Picture API 中传播的用户激活，以及键盘可聚焦滚动容器等众多功能。Adriana Jara 详细介绍了 Chrome 127 中面向开发者的新功能。
Chrome 如何帮助用户安装他们重视的应用
Updated 2024年7月23日
Chrome 的内部用户研究表明，许多用户都非常重视安装 Web 应用。这样做有诸多好处，例如： Chrome 和 Web 开发者可以通过多种方式提供帮助，包括新的机器学习促销功能。本文简要介绍了用户安装应用的方式。 符合 Chrome 的 可安装性条件 的应用会在 Chrome 桌面浏览器的地址栏中自动显示安装图标（在以下屏幕截图中突出显示）。用户可以点击以安装应用。 另一种安装方法是依次点按 更多 图标 保存和分享 安装 $appName 。
Chrome 127
Updated 2024年7月23日
Chrome 127 将于 2024 年 7 月 23 日开始发布，包含 CSS font-size-adjust、键盘可聚焦滚动容器，以及更多精彩内容。
WebGPU 的新变化 (Chrome 127)
Updated 2024年7月23日
针对 Android 上的 OpenGL ES、GPUAdapter 信息属性、WebAssembly 互操作性改进等方面的实验性支持。
Long Animation Frame API 现已发布
Updated 2024年6月24日
Long Animation Frame API (LoAF) 已经从 Chrome 123 开始提供，我们现在还更新了工具和指南，以帮助您充分利用以下新 API。
针对新 HTML <permission> 元素的源试用
Updated 2024年6月12日
Chrome 团队正在试验一种新的声明式 HTML <权限> 元素，该元素旨在请求用户获取对各种强大功能的使用权限。
WebGPU 的新变化 (Chrome 126)
Updated 2024年6月12日
提高了 maxTextureArrayLayers 限制、针对 Vulkan 后端优化了缓冲区上传、缩短了着色器编译时间、提交的命令缓冲区必须是唯一的，以及 Dawn 更新。
Chrome 126
Updated 2024年6月11日
Chrome 126 将于 2024 年 6 月 11 日推出，届时会进行跨文档视图转换、重新启用 CloseWatcher API，针对 Gamepad API 触发规则混乱，还有诸多其他功能。
Chrome 126 的新变化
Updated 2024年6月11日
Chrome 126 现已推出！凭借 ViewTransitions API 中对跨文档转换的支持，针对 Gamepad API 重新启用了 CloseWatcher API，触发器进行了混乱，还有许多其他功能以及更多其他功能。Adriana Jara 介绍了 Chrome 126 为开发者提供的所有详细信息。
跳过审核以查找符合条件的附加信息更改
Updated 2024年5月30日
我们很高兴地宣布推出一项新功能，该功能可让开发者使用声明式 Net Request API 跳过对 Manifest V3 扩展程序符合条件的更改的审核流程。
2024 年 I/O 大会 Web AI 总结：为您的下一个 Web 应用打造的新模型、工具和 API
Updated 2024年5月16日
阅读 2024 年 I/O 大会上的 Web AI 总结。了解适用于您的下一个 Web 应用的新模型、工具和 API。
Chrome 126 Beta 版
Updated 2024年5月16日
Chrome 126 Beta 版包含跨文档视图转换，以及 Gamepad API Trigger-Rumble 扩展程序和其他功能。
有助于加快 Web AI 速度的 WebAssembly 和 WebGPU 增强功能（第 2 部分）
Updated 2024年5月16日
第 2 部分（共 2 部分）。了解 WebAssembly 和 WebGPU 增强功能如何提高 Web 上的机器学习性能。
用于实现更快的 Web AI 的 WebAssembly 和 WebGPU 增强功能（第 1 部分）
Updated 2024年5月16日
第 1 部分（共 2 部分）。了解 WebAssembly 和 WebGPU 增强功能如何提升 Web 上的机器学习性能。
视图转换有哪些新变化？（2024 年 Google I/O 大会更新）
Updated 2024年5月16日
宣布推出适用于 MPA 的跨文档视图转换、使用活动类型的选择性视图转换，以及使用 view-transition-class 共享动画样式。
Chrome 125
Updated 2024年5月14日
Chrome 125 将于 2024 年 5 月 14 日开始发布，其中包含 CSS Anchor 定位、Compute Pressure API 和新的 Baseline 功能，以及更多其他功能。
2024 年 Google I/O 大会的 10 项更新：为每位 Web 开发者解锁 AI 的强大功能
Updated 2024年5月14日
通过 Google I/O 开发者主旨演讲和讲座探索精彩功能。
Chrome 125 的新变化
Updated 2024年5月14日
Chrome 125 现已推出！利用 CSS Anchor Positioning API、Compute Pressure API、Storage Access API 扩展等等。Adriana Jara 介绍了 Chrome 125 为开发者提供的所有详细信息。
Spotify 如何使用 Picture-in-Picture API 构建 Spotify Miniplayer
Updated 2024年5月13日
了解 Spotify 迷你播放器如何从“画布摄影”转变为通过 Document Picture-in-Picture API 实现的精致体验。
使用 Chrome 中的工具进行顺畅的自动化测试
Updated 2024年5月9日
简要介绍 Puppeteer、Chrome Headless 和 Chrome for Testing，以及 Chrome 工具团队提供的其他资源。
为什么 CSS 和界面功能对您的电子商务网站很重要？
Updated 2024年5月7日
了解电子商务网站如何从实现最新的 CSS 和界面功能（视图转换、滚动驱动的动画、Popover API 等）中受益。
针对非安全上下文的专用网络访问 (PNA) 弃用试用已结束 - 请实施 PNA 权限提示
Updated 2024年4月24日
如果要从无法转换成 HTTPS 的网站访问专用网络设备，您必须使用权限提示来放宽混合内容检查要求。
不注册用于控制 page 和 start_url 的 Service Worker
Updated 2024年4月16日
了解如何注册支持渐进式 Web 应用功能（例如离线功能、推送通知和可安装性）的 Service Worker。
Chrome 124
Updated 2024年4月16日
Chrome 124 将于 2024 年 4 月 16 日开始发布，其中包括 setHTMLUnsafe、WebSocket 流以及更多其他功能。
Chrome 124 的新变化
Updated 2024年4月16日
Chrome 124 现已推出！有两个新 API 支持从 JavaScript 使用声明性 shadow DOM。您可以在 Web Socket 中使用流。改进了视图过渡。还有很多其他功能。Pete LePage 介绍了 Chrome 124 中面向开发者的新功能的所有详细信息。
如何通过 PageSpeed Insights 查看 Chrome 用户体验报告数据
Updated 2024年4月9日
PageSpeed Insights (PSI) 是一款供 Web 开发者了解网页性能指标及改进方法的工具。在本指南中，您将了解如何使用 PSI 从 CrUX 中提取数据洞见，并更好地了解用户体验。
始终更新
清单版本
Updated 2025年3月6日
一个整数，用于指定您的软件包所需的清单文件格式版本。从 Chrome 开始 18 中，开发者 应该 指定 2 （不带引号），以便使用本说明中所述的格式 文档： 考虑从 Chrome 18 开始 弃用 清单版本 1。版本 2 目前并非 必需 ，但我们 在不久的将来，我们会停止支持使用已弃用的软件包 清单版本。尚未准备好跳转到 新的清单版本，可以明确指定版本 1 ，也可以不启用该密钥 如需详细了解清单文件格式的版本 1 和版本 2 之间的不同之处， manifest_version 文档。
存储区域的清单
Updated 2025年3月6日
与 local 和 sync 存储区域不同， managed 存储区域的结构必须为 声明为 JSON 架构 ，并经过 Chrome 的严格验证。此架构必须存储在 （由 "storage" 清单键的 "managed_schema" 属性指示）文件，并声明 应用支持的企业政策。 政策类似于选项，但是由系统管理员（而不是用户）配置的 从而为组织的所有用户预先配置应用。了解 Chrome 如何处理 政策 。 声明政策后，您可以通过 storage.managed API
清单 - 已启用离线功能
Updated 2025年3月6日
应用或扩展程序是否可离线工作。当 Chrome 检测到自己处于离线状态时，将在“新标签页”页面上突出显示此字段设为 true 的应用。 从 Chrome 35 开始，除非应用请求 "webview" 权限，否则应用被视为已启用离线功能，且 "offline_enabled" 的默认值为 true 。在这种情况下，系统会假定网络连接是必需的，并且 "offline_enabled" 默认为 false 。 "offline_enabled" 值还可用于确定在 ChromeOS 自助服务终端模式
清单 - 图标
Updated 2025年3月6日
代表扩展程序、应用或主题的一个或多个图标。您应始终提供 128x128 图标；安装期间以及由 Chrome 应用商店使用。扩展程序还应提供 48x48 的图标，在扩展程序管理页面 (chrome://extensions) 中使用。您还可以 指定将用作扩展程序页面的网站图标的 16x16 图标。 图标通常应采用 PNG 格式，因为 PNG 可最有效地支持透明度。他们 不过，可以采用 WebKit 支持的任何格式，包括 BMP、GIF、ICO 和 JPEG。这里有 指定图标的示例： 如果您使用
清单 - 名称和简称
Updated 2025年3月6日
name 和 short_name 清单属性是用于标识应用的简短纯文本字符串。您可以为这两个字段指定特定于语言区域的字符串；如需了解详情，请参阅 国际化 。 name （最多 45 个字符）是应用的主要标识符，是必填字段。 它显示在以下位置： short_name （建议不超过 12 个字符）是应用名称的简短版本。这是一个可选字段，如果未指定，则系统会使用 name ，但可能会将其截断。通常在没有足够空间来显示全名时使用简称，例如：
更新：活动页和后台页
Updated 2025年3月6日
清单文件格式
Updated 2025年3月6日
每个应用都有一个 JSON 格式的清单文件，名为 manifest.json ，它提供了重要的 信息。 以下代码显示了支持的 Google Apps 清单字段，其中包含指向 讨论每个字段。
已停用的网络功能
Updated 2025年3月6日
虽然 Chrome 应用使用的是网络平台，但部分网络功能已停用或以其他方式使用。这主要是为了避免安全问题和改进编程做法。下面总结了该 Web 平台已停用的功能以及可能的权宜解决方法：
清单 - 版本
Updated 2025年3月6日
一到四个以英文句点分隔的整数，用于标识此扩展程序的版本。有几项规则适用于整数：它们必须介于 0 到 65, 535 之间（包括 0 和 65, 535），并且非零整数不能以 0 开头。例如，99999 和 032 都无效。 以下是有效版本的一些示例： 自动更新系统会比较版本，以确定已安装的扩展程序是否需要更新。如果已发布的扩展程序的版本字符串比已安装的扩展程序更新，则该扩展程序会自动更新。 比较从最左边的整数开始。如果这些整数相等，则比较右侧的整数，依此类推。例如，1.2.0 是比
清单 - 要求
Updated 2025年3月6日
应用或扩展程序所需的技术。Chrome 应用商店等托管网站可能会使用 此列表以阻止用户安装无法在其计算机上正常运行的应用程序或扩展程序。 支持的要求目前包括“3D”和“插件”；可能还需要检查 。 “3D”表示 GPU 硬件加速。“webgl”是指 WebGL， API 。有关 Chrome 浏览器 3D 图形支持的详情，请参见关于 WebGL 和 3D 的帮助文章。 图形 。您可以列出应用所需的 3D 相关功能，如 示例： “插件”要求指明应用程序或扩展程序是否需要 NPAPI
清单 - 沙盒
Updated 2025年3月6日
警告 ：从版本 57 开始，Chrome 将不再允许使用外部 Web 内容（包括 嵌入式框架和脚本）。请改用 网页视图 。 定义要在沙盒化的唯一源中提供的一组应用或扩展程序页面。 以及要与它们搭配使用的内容安全政策处于沙盒中有两个影响： 沙盒化页面不受其余组件所使用的 内容安全政策 (CSP) 的约束 应用或扩展程序（具有自己单独的 CSP 值）。也就是说，它可以 使用内嵌脚本和 eval 。 例如，以下代码展示了如何指定在具有 自定义 CSP： 如果未指定，则默认的
externally_connectable
Updated 2025年3月6日
externally_connectable 清单属性用于声明哪些扩展程序、应用和网页可以 通过 runtime.connect 和 runtime.sendMessage 连接到您的应用。 有关消息传递的教程，请参阅 跨扩展程序和应用消息传递 和 发送消息 来自网页 。 如果未在应用清单中声明 externally_connectable ，则所有扩展程序和应用都可以 已连接，但所有网页都无法连接。因此，当您更新清单以使用 externally_connectable ，如果未指定
清单 - Nacl 模块
Updated 2025年3月6日
从 MIME 类型到处理每种类型的 Native Client 模块的一个或多个映射。对于 以下代码段中粗体代码会将 Native Client 模块注册为 OpenOffice 电子表格 MIME 类型的处理程序。 “path”的值是 Native Client 清单（.nmf 文件）在扩展程序中的位置 目录。有关 Native Client 和.nmf 文件的详情，请参见 Native Client 技术 概览 。 每个 MIME 类型只能与一个.nmf 文件相关联，但单个.nmf
清单 - 说明
Updated 2025年3月6日
描述扩展程序的纯文本字符串（无 HTML 或其他格式；不超过 132 个字符）。该说明应适合浏览器的扩展程序管理界面和 Chrome 应用商店 。您可以为此字段指定特定于语言区域的字符串；如需了解详情，请参阅 国际化 。
清单 - 键
Updated 2025年3月6日
此值可用于在开发期间加载扩展程序、应用或主题时控制其唯一 ID。 如需获取合适的键值对，请先通过.crx 文件安装扩展程序（您可能需要 上传扩展程序 或 手动将其打包 ）。然后，在 用户数据目录 中查找文件 Default/Extensions/_<extensionId>_/_<versionString>_/manifest.json 。您会看到已填充的键值对。
清单 - 默认语言区域
Updated 2025年3月6日
指定包含此扩展程序的默认字符串的 _locales 的子目录。在具有 _locales 目录的扩展程序中， 必须 填写此字段；在没有 _locales 目录的扩展程序中，此字段 必须不存在 。如需了解详情，请参阅 国际化 。
工作区流
Updated 2025年3月6日
RouteHandlerCallbackOptions StreamSource | Promise< StreamSource > 响应 ReadableStream BodyInit 接受多个来源 promise，每个 promise 都可以解析为 Response、 ReadableStream 或 BodyInit 。 返回一个对象，该对象公开了 ReadableStream 以及每个单独的流 以及一个 promise（用于指示 流完成（适用于传递给 FetchEvent 的
eBay 如何通过无缝凭据共享功能将登录成功率提高了 10%
Updated 2025年3月6日
了解 eBay 如何使用数字资产链接实现顺畅的凭据共享，从而将登录成功率提高了 10%。了解如何实现安全的跨平台身份验证并提升用户体验。
Chrome Web Store
Updated 2025年3月4日
Chrome Web Store 一个在线市场，用户可以在其中浏览扩展程序和主题。在那里发布您的扩展程序，让全世界的用户都能访问。 dashboard 开发者信息中心 发布您的扩展程序并管理您的商店商品。 local_mall Chrome Web Store 浏览 Chrome 应用商店中的扩展程序。 policy 开发者政策 为 Chrome 应用商店创建扩展程序的最佳做法和指南。 在发布您的首个扩展程序之前，请务必遵循这些步骤和最佳做法，以确保顺利提交扩展程序。 准备扩展程序文件
chrome.contentSettings
Updated 2025年2月28日
使用 chrome.contentSettings API 更改用于控制网站是否可以使用 Cookie、JavaScript 和插件等功能的设置。更一般地说，内容设置可让您针对每个网站（而非全局）自定义 Chrome 的行为。 您必须在扩展程序的清单中声明 "contentSettings" 权限，才能使用该 API。例如： 您可以使用模式来指定每项内容设置影响的网站。例如， https://*.youtube.com/* 指定了 youtube.com 及其所有子网域。内容设置模式的语法与
chrome.bookmarks
Updated 2025年2月28日
此权限会 触发警告 。 使用 chrome.bookmarks API 创建、整理和以其他方式处理书签。另请参阅 替换页面 ，您可以使用该页面创建自定义书签管理器页面。 您必须在 扩展程序清单 中声明“书签”权限，才能使用 Bookmarks API。例如： 书签采用树状结构，其中树中的每个节点都是一个书签或文件夹（有时称为 组 ）。树中的每个节点都由 bookmarks.BookmarkTreeNode 对象表示。 BookmarkTreeNode 属性在整个 chrome.bookmarks
chrome.bookmarks
Updated 2025年2月28日
使用 chrome.bookmarks API 创建、整理和以其他方式处理书签。另请参阅 替换页面 ，您可以使用该页面创建自定义书签管理器页面。 您必须在 扩展程序清单 中声明“书签”权限，才能使用 Bookmarks API。例如： 书签采用树状结构，其中树中的每个节点都是一个书签或文件夹（有时称为 组 ）。树中的每个节点都由 bookmarks.BookmarkTreeNode 对象表示。 BookmarkTreeNode 属性在整个 chrome.bookmarks API
chrome.contentSettings
Updated 2025年2月28日
使用 chrome.contentSettings API 更改用于控制网站是否可以使用 Cookie、JavaScript 和插件等功能的设置。更一般地说，内容设置可让您针对每个网站（而非全局）自定义 Chrome 的行为。 您必须在扩展程序的清单中声明“contentSettings”权限，才能使用该 API。例如： 您可以使用模式来指定每项内容设置影响的网站。例如， https://*.youtube.com/* 指定了 youtube.com 及其所有子网域。内容设置模式的语法与
人工智能
Updated 2025年2月28日
Chrome 上的 AI 欢迎来到 AI 赋能的网络时代。了解 AI 如何让开发者更轻松地打造强大的 Web 体验。 重新构想 Chrome 专用 Gemini Nano 的强大功能。 内置 AI 我们将在 Chrome 中引入 Gemini Nano，这是 Gemini 生态系统中最高效的模型。 在客户端工作 客户端 AI 为用户带来强大的模型，同时保护数据隐私并缩短延迟时间。 开始使用 了解开始使用内置 AI 构建功能和应用时需满足的要求。 可用的 API 查看可在 Chrome 中与
chrome.app.runtime
Updated 2025年2月24日
使用 chrome.app.runtime API 管理应用生命周期。应用运行时会管理应用安装、控制活动页面，并且可以随时关闭应用。 任意（可选） 可选的开发者指定数据，要嵌入的应用在做出嵌入决策时可以使用这些数据。 字符串 void 允许 embedderId 将此应用嵌入 <appview> 元素中。 url 用于指定要嵌入的内容。 allow 函数如下所示： 字符串 void 阻止 embedderId 将此应用嵌入 <appview> 元素中。 deny
chrome.printing
Updated 2025年2月24日
使用 chrome.printing API 将打印作业发送到安装在 Chromebook 上的打印机。 您需要在 扩展程序清单 中声明 "printing" 权限，才能使用所有 chrome.printing 方法和事件。例如： 以下示例演示了如何使用打印命名空间中的每种方法。此代码复制自或基于 extensions-samples GitHub 代码库中的 api-samples/printing 。 以下示例使用 onJobStatusChanged 处理脚本来在 jobStatus
chrome.userScripts
Updated 2025年2月24日
使用 userScripts API 在“用户脚本”上下文中执行用户脚本。 如需使用 User Scripts API ( chrome.userScripts )，请将 "userScripts" 权限添加到 manifest.json，并为您要运行脚本的网站添加 "host_permissions" 。 用户脚本是指注入到网页中用于修改其外观或行为的一小段代码。与其他扩展程序功能（例如 内容脚本 和 chrome.scripting API ）不同，用户脚本 API
chrome.sessions
Updated 2025年2月24日
使用 chrome.sessions API 查询和恢复浏览会话中的标签页和窗口。 字符串 外部设备的名称。 会话 [] 外部设备的打开窗口会话列表，按修改时间从最近到最久排序。 编号（可选） 要从请求的列表中提取的条目数量上限。省略此参数可提取最大条目数 ( sessions.MAX_SESSION_RESULTS )。 数值 窗口或标签页关闭或修改的时间，以自公元纪年开始计算的秒数表示。 标签页 （可选） tabs.Tab （如果此条目描述的是标签页）。系统会设置此值或
chrome.printing
Updated 2025年2月24日
使用 chrome.printing API 将打印作业发送到安装在 Chromebook 上的打印机。 您需要在 扩展程序清单 中声明 "printing" 权限，才能使用所有 chrome.printing 方法和事件。例如： 以下示例演示了如何使用打印命名空间中的每种方法。此代码复制自 extensions-samples GitHub 代码库中的 api-samples/printing ，或基于该代码库。 以下示例使用 onJobStatusChanged 处理脚本来在
chrome.sessions
Updated 2025年2月24日
使用 chrome.sessions API 查询和恢复浏览会话中的标签页和窗口。 字符串 外部设备的名称。 会话 [] 外部设备的打开窗口会话列表，按修改时间从最近到最久排序。 编号（可选） 要从请求的列表中提取的条目数量上限。省略此参数可提取最大条目数 ( sessions.MAX_SESSION_RESULTS )。 数值 窗口或标签页关闭或修改的时间，以自公元纪年开始计算的秒数表示。 标签页 （可选） tabs.Tab （如果此条目描述的是标签页）。系统会设置此值或
探索 Chrome
Updated 2025年2月21日
探索 Chrome Chrome 134（Beta 版） Chrome 133 Chrome 132 Chrome 131 Chrome 130 Chrome 129 Chrome 128 Chrome 127 Chrome 126 Chrome 125 Chrome 124 Chrome 123 Chrome 122 Chrome 121 Chrome 120 Chrome 119 Chrome 的新变化 开发者工具 开发者工具提示 工程博客 无障碍 媒体 WebGPU 博客 案例研究 视频
chrome.i18n
Updated 2025年2月12日
使用 chrome.i18n 基础架构在整个应用或扩展程序中实现国际化。 如果扩展程序包含 /_locales 目录，则 manifest 必须定义 "default_locale" 。 您需要将其所有面向用户的字符串放入名为 messages.json 的文件中。每次添加新的语言区域时，您都需要在名为 /_locales/_localeCode_ 的目录下添加一个消息文件，其中 localeCode 是一个代码，例如英语的代码为 en 。 以下是支持英语 ( en )、西班牙语 ( es )
在 Windows 上基于 Chromium 的浏览器中改进了文本渲染
Updated 2025年2月12日
Edge 团队添加了直接在 Chromium 中遵循 Windows ClearType 调谐器值的支持，从而改进了 Windows 上基于 Chromium 的浏览器中的文本渲染效果。
chrome.storage
Updated 2025年2月11日
使用 chrome.storage API 存储、检索和跟踪用户数据的更改。 如需使用 Storage API，请在扩展程序 manifest 中声明 "storage" 权限。例如： Storage API 提供了一种扩展程序专用的方法来保留用户数据和状态。它与 Web 平台的存储 API（ IndexedDB 和 Storage ）类似，但旨在满足扩展程序的存储需求。以下是一些关键功能： 虽然扩展程序可以在某些上下文（弹出式窗口和其他 HTML 页面）中使用 Storage 接口（可通过
chrome.storage
Updated 2025年2月11日
使用 chrome.storage API 存储、检索和跟踪用户数据的更改。 Storage API 提供了一种扩展程序专用的方法来保留用户数据和状态。它类似于 Web 平台的存储 API（ IndexedDB 和 Storage ），但旨在满足扩展程序的存储需求。以下是一些关键功能： 虽然扩展程序可以在某些上下文（弹出式窗口和其他 HTML 页面）中使用 [ Storage ][mdn-storage] 接口（可通过 window.localStorage
LCP 图片子部分和 RTT 现已在 CrUX 中推出
Updated 2025年2月11日
了解 2025 年 2 月版本中 Chrome 用户体验报告 (CrUX) 的变更，包括 LCP 图片子部分、LCP 资源类型和 RTT。
如何使用 CrUX BigQuery 数据集
Updated 2025年2月11日
在本指南中，您将了解如何使用 BigQuery 针对 CrUX 数据集编写查询，以提取有关网络用户体验状况的见解深刻结果。
chrome.enterprise.platformKeys
Updated 2025年2月4日
使用 chrome.enterprise.platformKeys API 生成密钥并为这些密钥安装证书。证书将由平台管理，可用于 TLS 身份验证、网络访问，或由其他扩展程序通过 chrome.platformKeys 使用。 如需使用此 API 注册客户端证书，请按以下步骤操作： 使用 enterprise.platformKeys.getTokens 获取所有可用令牌。 找到 id 等于 "user" 的令牌。之后使用此令牌。 使用 generateKey 令牌方法（在
chrome.enterprise.platformKeys
Updated 2025年2月4日
使用 chrome.enterprise.platformKeys API 生成密钥并为这些密钥安装证书。证书将由平台管理，可用于 TLS 身份验证、网络访问，或由其他扩展程序通过 chrome.platformKeys 使用。 如需使用此 API 注册客户端证书，请按以下步骤操作： 使用 enterprise.platformKeys.getTokens() 获取所有可用令牌。 找到 id 等于 "user" 的令牌。之后使用此令牌。 使用 generateKey() 令牌方法（在
chrome.runtime
Updated 2025年1月30日
使用 chrome.runtime API 检索服务工件、返回清单的详细信息，以及监听和响应扩展程序生命周期中的事件。您还可以使用此 API 将网址的相对路径转换为完全限定网址。 Runtime API 提供了多种方法来支持您的扩展程序可使用的多种功能领域： 运行时 API 上的大多数方法 不需要 任何权限，但 sendNativeMessage 和 connectNative 需要 nativeMessaging 权限。 以下示例展示了如何在清单中声明 nativeMessaging 权限：
chrome.permissions
Updated 2025年1月30日
使用 chrome.permissions API 在运行时（而不是安装时）请求 声明的可选权限 ，以便用户了解需要这些权限的原因，并仅授予必要的权限。 权限警告旨在说明 API 授予的功能，但其中一些警告可能并不明显。借助 Permissions API，开发者可以解释权限警告并逐步引入新功能，让用户能够无风险地了解扩展程序。这样，用户可以指定他们愿意授予的访问权限级别以及想要启用的功能。 例如， 可选权限扩展程序 的核心功能会替换新标签页。其中一个功能是显示用户当天的目标。此功能仅需要
chrome.permissions
Updated 2025年1月30日
使用 chrome.permissions API 在运行时（而不是安装时）请求 声明的可选权限 ，以便用户了解需要这些权限的原因，并仅授予必要的权限。 权限警告旨在说明 API 授予的功能，但其中一些警告可能并不明显。借助 Permissions API，开发者可以解释权限警告并逐步引入新功能，让用户能够无风险地了解扩展程序。这样，用户可以指定他们愿意授予的访问权限级别以及他们想要启用的功能。 例如， 可选权限扩展程序 的核心功能会替换新标签页。其中一个功能是显示用户当天的目标。此功能仅需要
WebGPU（Chrome 133）中的新变化
Updated 2025年1月29日
新增了 unorm8x4-bgra 和 1 个组成部分的顶点格式，允许使用未定义值请求未知限制，WGSL 对齐规则发生变化，WGSL 性能因舍弃而提升，等等。
Chrome 中的新变化
Updated 2025年1月23日
Chrome 中的新变化 参阅我们的文档和博客，了解 Chrome 的最新动态。 新增了内容和重大文档更新。 article LLM 如何流式传输回答 新增了文档，介绍了在 AI 中，服务器和客户端的流式数据的运作方式。 article Chrome 应用商店的通知和申诉 Chrome 应用商店的通知和申诉流程已更新。 article 源试用中的 AI API 从 Chrome 131 开始，Translator API、Summarizer API 和 Prompt API for
简化了通行密钥的 WebAuthn 功能检测
Updated 2025年1月21日
了解如何使用 `getClientCapabilities()` 检测 WebAuthn 功能，以及如何为用户量身定制身份验证工作流。
Google 密码管理工具中的通行密钥现已在 iOS 设备上推出
Updated 2025年1月16日
在 iOS 17 或更高版本上，Chrome 现在可以在 Google 密码管理工具 (GPM) 中创建、同步和使用通行密钥进行身份验证。这样一来，您就可以在任何安装了 Chrome 的设备上使用 GPM 中的通行密钥。
Chrome 132 中的新变化
Updated 2025年1月14日
Chrome 132 现已发布！Dialog 元素会获取 ToggleEvent，支持元素级视频共享，并且 FileSystem Access API 支持 Android 和 WebView。
chrome.sockets.udp
Updated 2025年1月13日
使用 chrome.sockets.udp API 通过 UDP 连接在网络上发送和接收数据。此 API 取代了之前在“socket”API 中找到的 UDP 功能。 必须在 清单 中声明以下键才能使用此 API。 数值 新创建的套接字的 ID。请注意，通过此 API 创建的套接字 ID 与通过其他 API（例如已废弃的 [ socket ](../socket/) API）创建的套接字 ID 不兼容。 DNS 解析偏好设置。默认值为 any ，并使用当前的操作系统配置，该配置可能会返回
chrome.tabs
Updated 2025年1月13日
使用 chrome.tabs API 与浏览器的标签页系统进行交互。您可以使用此 API 在浏览器中创建、修改和重新排列标签页。 Tabs API 不仅提供用于操作和管理标签页的功能，还可以检测标签页的 语言 、截取 屏幕截图 ，以及与标签页的内容脚本进行 通信 。 大多数功能无需任何权限即可使用。例如： 创建 新标签页、 重新加载 标签页、 导航 到其他网址等。 开发者在使用 Tabs API 时应注意三项权限。 此权限不会授予对 chrome.tabs
chrome.tabs
Updated 2025年1月13日
使用 chrome.tabs API 与浏览器的标签页系统进行交互。您可以使用此 API 在浏览器中创建、修改和重新排列标签页。 Tabs API 不仅提供用于操作和管理标签页的功能，还可以检测标签页的 语言 、截取 屏幕截图 ，以及与标签页的内容脚本进行 通信 。 大多数功能无需任何权限即可使用。例如： 创建 新标签页、 重新加载 标签页、 导航 到其他网址等。 开发者在使用 Tabs API 时应注意三项权限。 以下示例展示了如何在 manifest 中声明每项权限：
chrome.ttsEngine
Updated 2025年1月13日
使用 chrome.ttsEngine API 通过扩展程序实现文本转语音(TTS) 引擎。如果您的扩展程序使用此 API 进行注册，那么当任何扩展程序或 Chrome 应用使用 tts API 生成语音时，该扩展程序将会收到包含要朗读的语音和其他参数的事件。然后，您的扩展程序可以使用任何可用的 Web 技术来合成和输出语音，并将事件发送回调用函数以报告状态。 扩展程序可以将自己注册为语音引擎。这样，它就可以拦截对 tts.speak() 和 tts.stop()
chrome.cookies
Updated 2025年1月13日
使用 chrome.cookies API 查询和修改 Cookie，并在 Cookie 发生更改时收到通知。 如需使用 Cookie API，您必须在清单中声明“Cookie”权限，以及您要访问 Cookie 的所有主机的 主机权限 。例如： 借助 分区 Cookie ，网站可以标记某些 Cookie 应采用顶级框架的来源作为键。这意味着，如果网站 A 使用 iframe 嵌入到网站 B 和网站 C 中，则分区 Cookie 在每个网站中可以具有不同的值。 chrome.cookies
chrome.ttsEngine
Updated 2025年1月13日
使用 chrome.ttsEngine API 通过扩展程序实现文本转语音(TTS) 引擎。如果您的扩展程序使用此 API 进行注册，那么当任何扩展程序或 Chrome 应用使用 tts API 生成语音时，该扩展程序将收到包含要朗读的语音和其他参数的事件。然后，您的扩展程序可以使用任何可用的 Web 技术来合成和输出语音，并将事件发送回调用函数以报告状态。 扩展程序可以将自己注册为语音引擎。这样一来，它就可以拦截对 tts.speak 和 tts.stop
chrome.cookies
Updated 2025年1月13日
使用 chrome.cookies API 查询和修改 Cookie，并在 Cookie 发生更改时收到通知。 如需使用 Cookie API，请在清单中声明 "cookies" 权限，并为您要访问 Cookie 的所有主机声明 主机权限 。例如： 借助 分区 Cookie ，网站可以标记某些 Cookie 应采用顶级框架的来源作为键。例如，这意味着，如果网站 A 使用 iframe 嵌入到网站 B 和网站 C 中，则来自 A 的分区 Cookie 的嵌入版本在 B 和 C 中可以具有不同的值。
chrome.appviewTag
Updated 2025年1月13日
使用 appview 标记在您的 Chrome 应用中嵌入其他 Chrome 应用。详情请参阅 用法 。 对象 可选的开发者指定数据，要嵌入的应用在做出嵌入决策时可以使用这些数据。 字符串 发送嵌入请求的应用的 ID。 void 允许嵌入请求。 allow 函数如下所示： 字符串 指定要嵌入的内容。 void 阻止嵌入请求。 deny 函数如下所示： 请求嵌入其他应用。 字符串 要嵌入的应用的扩展程序 ID。 任意（可选） 可选的开发者指定数据，要嵌入的应用在做出嵌入决策时可以使用这些数据。
WebGPU（Chrome 132）中的新变化
Updated 2025年1月8日
纹理视图使用、32 位浮点纹理混合、GPUDevice adapterInfo 属性、使用无效格式配置画布上下文会抛出 JavaScript 错误、过滤纹理上的采样器限制、扩展的子组实验、改进开发者体验、对 16 位归一化纹理格式的实验性支持等。
chrome.certificateProvider
Updated 2024年12月22日
使用此 API 将证书公开给平台，平台可以使用这些证书进行 TLS 身份验证。 如需使用此 API 向 ChromeOS 公开客户端证书，请按以下步骤操作： 实际步骤顺序可能会有所不同。例如，如果使用用于自动选择证书的企业政策，系统将不会要求用户选择证书（请参阅 AutoSelectCertificateForUrls 和 面向用户的 Chrome 政策 ）。 在扩展程序中，这可能类似于以下代码段： 支持的加密签名算法类型。 "RSASSA_PKCS1_v1_5_MD5_SHA1" 使用
chrome.extension
Updated 2024年12月22日
chrome.extension API 包含可供任何扩展程序页面使用的实用程序。它支持在扩展程序及其内容脚本之间或扩展程序之间交换消息，如 消息传递 中所详述。 扩展程序视图的类型。 "tab" "popup" 对于在无痕式标签页中运行的内容脚本，以及在无痕式进程中运行的扩展程序页面，此值为 true。后者仅适用于具有“split”incognito_behavior 的扩展程序。 布尔值 返回当前扩展程序中运行的后台页面的
chrome.system.display
Updated 2024年12月21日
使用 system.display API 查询显示元数据。 一个枚举，用于指明系统是否检测到显示屏并使用了显示屏。如果系统未检测到显示屏（可能已断开连接，或因进入休眠模式等原因而被视为已断开连接），则系统会将显示屏视为“非活跃”。例如，此状态用于在所有显示屏断开连接时保留现有显示屏。 "active" "inactive" 数值 显示屏的高度（以像素为单位）。 数值 左上角的 x 坐标。 数值 左上角的 y 坐标。 数值 显示屏的宽度（以像素为单位）。 字符串 显示屏的唯一标识符。 数值
chrome.system.display
Updated 2024年12月21日
使用 system.display API 查询显示元数据。 一个枚举，用于指明系统是否检测到显示屏并使用了显示屏。如果系统未检测到显示屏（可能已断开连接，或因进入休眠模式等原因而被视为已断开连接），则系统会将显示屏视为“非活跃”。例如，此状态用于在所有显示屏断开连接时保留现有显示屏。 "active" "inactive" 数值 显示屏的高度（以像素为单位）。 数值 左上角的 x 坐标。 数值 左上角的 y 坐标。 数值 显示屏的宽度（以像素为单位）。 字符串 显示屏的唯一标识符。 数值
chrome.action
Updated 2024年12月21日
使用 chrome.action API 控制 Google Chrome 工具栏中的扩展程序图标。 必须在 清单 中声明以下键才能使用此 API。 如需使用 chrome.action API，请指定 3 的 "manifest_version" ，并在 清单文件 中添加 "action" 键。 "action" 键（及其子项）是可选的。如果未包含该图标，您的扩展程序仍会显示在工具栏中，以便用户访问扩展程序的菜单。因此，我们建议您始终至少添加 "action" 和 "default_icon"
chrome.commands
Updated 2024年12月21日
使用 Commands API 添加可在扩展程序中触发操作的键盘快捷键，例如用于打开浏览器操作或向扩展程序发送命令的操作。 必须在 清单 中声明以下键才能使用此 API。 借助 Commands API，扩展程序开发者可以定义特定命令，并将其绑定到默认的按键组合。扩展程序接受的每个命令都必须在 扩展程序清单 中声明为 "commands" 对象的属性。 属性键将用作命令的名称。命令对象可以采用两个属性。
使用远程调试时不支持此操作
Updated 2024年12月21日
某些 WebDriver 命令（例如调整浏览器窗口大小）需要将 Chrome 扩展程序加载到浏览器中。ChromeDriver 通常会在每次启动新的 Chrome 会话时加载此“自动化扩展程序”。 不过，ChromeDriver 可以被指示连接到现有 Chrome 会话，而不是启动新的会话。为此，请使用 Capabilities （也称为
ChromeOS
Updated 2024年12月18日
所有 ChromeOS 测试映像均在 /usr/local/chromedriver/ 中安装了 ChromeDriver 二进制文件。该二进制文件会更新为该测试映像中的相同版本的 Chrome。也就是说，您始终使用的是最新版 ChromeDriver。 如果您的测试预计将针对 ChromeDriver 二进制文件的稳定 build 运行，您需要在测试中编写自己的代码来下载特定二进制文件，并替换 /usr/local/chromedriver/ 中的二进制文件。 您可以编写一个使用
chrome.certificateProvider
Updated 2024年12月18日
使用此 API 将证书公开给平台，平台可以使用这些证书进行 TLS 身份验证。 如需使用此 API 向 ChromeOS 公开客户端证书，请按以下步骤操作： 实际步骤顺序可能会有所不同。例如，如果使用自动选择证书的企业政策，系统就不会要求用户选择证书（请参阅 AutoSelectCertificateForUrls 和 面向用户的 Chrome 政策 ）。 在扩展程序中，这可能类似于以下代码段： 支持的加密签名算法类型。 "RSASSA_PKCS1_v1_5_MD5_SHA1" 使用
chrome.extension
Updated 2024年12月18日
chrome.extension API 包含可供任何扩展程序页面使用的实用程序。它支持在扩展程序及其内容脚本之间或扩展程序之间交换消息，如 消息传递 中所详述。 扩展程序视图的类型。 "tab" "popup" 对于在无痕式标签页中运行的内容脚本，以及在无痕式进程中运行的扩展程序页面，此值为 true。后者仅适用于具有“split”incognito_behavior 的扩展程序。 布尔值 请使用 runtime.lastError 。 如果异步扩展程序 API
性能日志
Updated 2024年12月17日
ChromeDriver 支持性能日志记录，您可以通过该日志获取“时间轴”“网络”和“网页”网域的事件，以及指定轨迹类别的 轨迹数据 。 默认情况下，系统不会启用性能日志记录功能。因此，在创建新会话时，您必须启用此功能。 启用后，性能日志会收集时间轴、网络和网页事件。如需同时启用跟踪功能或自定义性能日志记录，请继续阅读。 查看由 Michael Klepikov 撰写的 使用默认选项的性能日志记录完整示例 。 Angular Benchpress 也使用性能日志记录。
下载内容
Updated 2024年12月17日
以下是支持较低版本 Chrome 的 ChromeDriver 版本。 如需详细了解如何选择正确的 ChromeDriver 版本，请参阅 版本选择 页面。 支持 Chrome 114 版 如需了解详情，请参阅 版本说明 。 支持 Chrome 114 版 如需了解详情，请参阅 版本说明 。 支持 Chrome 113 版 如需了解详情，请参阅 版本说明 。 支持 Chrome 113 版 如需了解详情，请参阅 版本说明 。 支持 Chrome 112 版 如需了解详情，请参阅 版本说明 。
ChromeDriver 崩溃
Updated 2024年12月17日
如需诊断和修复 ChromeDriver 崩溃问题，您可以选择以下几种方法。这仅适用于 ChromeDriver 崩溃，而非 Chrome 崩溃或关闭。 在 Windows 上，您可能会看到如下内容： 创建一个重现问题的用例，以便 ChromeDriver 贡献者使用该用例来重现和调试问题。即使崩溃并非 100% 发生，也无妨。 请提交 bug 并附上重现问题的测试用例。这通常是获得帮助的最快方式。 如需创建和调试崩溃转储，您需要使用调试版 ChromeDriver。我们没有
Chrome 无法立即启动或崩溃
Updated 2024年12月17日
使用特殊的测试框架（可能是 IDE）或持续构建系统（例如 Jenkins）运行 ChromeDriver 或 Chrome 时，这种情况经常会发生。 尝试从普通用户命令提示符启动与您的测试使用的相同 Chrome 二进制文件。确认 chromedriver.log 文件中使用的 Chrome 二进制文件。如果您向 Chrome 传递特殊的命令行开关或参数，请务必也将它们包含在内。如果 Chrome 未能正常启动，您需要修正 Chrome 的安装。请尝试重新安装。 假设您可以通过命令提示运行
移动设备模拟
Updated 2024年12月17日
Chrome 允许用户通过 使用 Chrome 开发者工具启用设备模式 ，在桌面版 Chrome 中模拟移动设备上的 Chrome。此功能可加快 Web 开发速度，让开发者无需使用真实设备，即可快速测试网站在移动设备中的呈现方式。ChromeDriver 还可以使用字典值指定的“mobileEmulation”功能来模拟设备。 与开发者工具一样，ChromeDriver 中也有两种方法可以启用移动设备模拟： “mobileEmulation”字典的格式取决于所需的方法。
键盘支持
Updated 2024年12月17日
目前，ChromeDriver 仅支持配置了美国键盘的系统。 当 ChromeDriver 检测到此状态时，会记录以下内容： 没有美国键盘的用户在执行 sendKeys 或 TypeElement 命令时可能会遇到按键丢失的问题。 作为一种权宜解决方法，我们建议此类用户在系统配置中将采用 QWERTY 布局的美国键盘添加为次要选项。这样一来，ChromeDriver 便可使用美国键盘配置。 一如既往，ChromeDriver 是一个开源项目，我们欢迎您贡献代码。
Android
Updated 2024年12月17日
最新的 ChromeDriver 二进制文件 已打包为适用于各种主机平台的 ZIP 文件。 您可以在 下载 部分找到较低版本的 ChromeDriver。 ChromeDriver 支持在 Chrome 浏览器（30 及更高版本）以及启用了 Web 调试 和 JavaScript 的 Android 4.4 (KitKat) 及更高版本中基于 WebView 的应用上运行测试。 您可以通过以下方式安装 Chrome 应用： 稳定版：
Canary 版
Updated 2024年12月17日
ChromeDriver Canary 版包含最新的 ChromeDriver 功能。系统每天都会构建和提供多个新的二进制文件。 请注意，此版本专为开发者和早期采用者设计，有时可能会完全崩溃。 从 M115 开始，Chrome 测试版可用性信息中心会提供每个发布渠道（包括 Canary 渠道）的最新 Chrome + ChromeDriver 版本。如需自动下载版本，您可以使用方便的 JSON 端点。 对于较低版本，您可以按如下方式找到 Canary build： 通常，最好选择最新的
CSS Wrapped 2024
Updated 2024年12月5日
加入 Chrome DevRel 团队和滑板 Chrome Dino，一起探索 2024 年为 Chrome 和 Web 平台推出的最新 CSS。
chrome.socket
Updated 2024年11月30日
使用 chrome.socket API 通过 TCP 和 UDP 连接在网络上发送和接收数据。 注意 ：从 Chrome 33 开始，此 API 已废弃，取而代之的是 sockets.udp 、 sockets.tcp 和 sockets.tcpServer API。 数值 number 可选 已接受的套接字的 ID。 数值 新创建的套接字的 ID。 字符串 可用的 IPv4/6 地址。 字符串 适配器的底层名称。在 *nix 上，这通常为“eth0”“lo”等。 数值 前缀长度
chrome.bluetoothSocket
Updated 2024年11月30日
使用 chrome.bluetoothSocket API 通过 RFCOMM 和 L2CAP 连接向蓝牙设备发送和接收数据。 必须在 清单 中声明以下键才能使用此 API。 "system_error" 系统发生错误，连接可能无法恢复。 "not_listening" 套接字未监听。 AcceptError 一个错误代码，用于指明出现了什么问题。 字符串 错误消息。 数值 服务器套接字标识符。 数值 客户端套接字标识符，即新建立的连接的套接字标识符。此套接字标识符应仅与
chrome.browser
Updated 2024年11月30日
使用 chrome.browser API 与与当前应用和 Chrome 个人资料关联的 Chrome 浏览器进行交互。 字符串 新标签页初次打开时要导航到的网址。 在与当前应用和 Chrome 个人资料关联的浏览器窗口中打开新标签页。如果未打开 Chrome 个人资料的浏览器窗口，系统会先打开一个新窗口，然后再创建新标签页。 OpenTabOptions 配置标签页的打开方式。 函数（可选） callback 参数如下所示： Promise<void> 只有 Manifest V3
chrome.syncFileSystem
Updated 2024年11月30日
使用 chrome.syncFileSystem API 在 Google 云端硬盘上保存和同步数据。此 API 不适用于访问存储在 Google 云端硬盘中的任意用户文档。它提供应用专用可同步存储空间，以供离线和缓存使用，这样一来，相同的数据便可在不同的客户端中使用。如需详细了解如何使用此 API，请参阅 管理数据 。 "last_write_win" “manual” SyncAction （可选） 执行的同步操作，用于触发 onFileStatusChanged 事件。操作值可以是
chrome.bluetooth
Updated 2024年11月30日
使用 chrome.bluetooth API 连接到蓝牙设备。所有函数均通过 chrome.runtime.lastError 报告失败。 必须在 清单 中声明以下键才能使用此 API。 字符串 适配器的地址，格式为“XX:XX:XX:XX:XX:XX”。 布尔值 指示适配器是否可用（即是否已启用）。 布尔值 指示适配器当前是否正在进行发现。 字符串 适配器的直观易懂的名称。 布尔值 指示适配器是否已接通电源。 FilterType （过滤条件类型）- 可选
chrome.mdns
Updated 2024年11月30日
使用 chrome.mdns API 通过 mDNS 发现服务。这包含 NSD 规范的部分功能：http://www.w3.org/TR/discovery-api/ 字符串 mDNS 通告服务的 IP 地址。 字符串[] mDNS 通告服务的元数据。 字符串 mDNS 通告服务的主机：端口对。 字符串 mDNS 通告服务的服务名称，... onServiceList 事件中包含的服务实例的数量上限。如果有更多实例可用，系统可能会从 onServiceList 事件中截断这些实例。 2048
chrome.serial
Updated 2024年11月30日
使用 chrome.serial API 对连接到串行端口的设备执行读写操作。 number 可选 请参阅 ConnectionOptions.bitrate 。如果使用非标准比特率，或者在查询底层设备时发生错误，此字段可能会被省略或不准确。 数值 查看 ConnectionOptions.bufferSize 数值 串行端口连接的 ID。 布尔值（可选） 请参阅 ConnectionOptions.ctsFlowControl 。如果在查询底层设备时发生错误，则可以省略此字段。
chrome.bluetoothLowEnergy
Updated 2024年11月30日
chrome.bluetoothLowEnergy API 用于使用 Generic Attribute Profile (GATT) 与蓝牙智能 (Low Energy) 设备通信。 必须在 清单 中声明以下键才能使用此 API。 ManufacturerData [] 可选 要包含在广告数据的“制造商专用数据”字段中的制造商专用数据的列表。 ServiceData [] 可选 要包含在广告数据的“服务数据”字段中的服务数据列表。 string[] 可选 要添加到广告数据的“服务
chrome.webviewTag
Updated 2024年11月30日
使用 webview 标记可通过网络主动加载来自网络的直播内容，并将其嵌入到 Chrome 应用中。您的应用可以控制 webview 的外观，与网络内容互动，在嵌入的网页中发起导航，对其中发生的错误事件做出响应，等等（请参阅 用法 ）。 用于确定 clearData 应清除哪些数据的选项。 number 可选 清除在此日期当天或之后累积的数据，以从公元纪年起算的毫秒数表示（可通过 JavaScript Date 对象的 getTime 方法访问）。如果不存在，则默认为 0
chrome.fontSettings
Updated 2024年11月30日
使用 chrome.fontSettings API 管理 Chrome 的字体设置。 如需使用 Font Settings API，您必须在 扩展程序清单 中声明 "fontSettings" 权限。例如： Chrome 允许某些字体设置取决于某些通用字体系列和语言脚本。例如，用于 sans-serif 简体中文的字体可能与用于 serif 日语的字体不同。 Chrome 支持的通用字体系列基于 CSS 通用字体系列 ，并在 GenericReference
chrome.usb
Updated 2024年11月30日
使用 chrome.usb API 与已连接的 USB 设备进行互动。此 API 可从应用上下文中访问 USB 操作。借助此 API，应用可以充当硬件设备的驱动程序。通过设置 runtime.lastError 并执行函数的常规回调来报告此 API 生成的错误。在这种情况下，回调的常规参数将未定义。 布尔值 这是有效配置吗？ number 配置编号。 字符串（可选） 配置说明。 ArrayBuffer 与此配置相关联的额外描述符数据。 InterfaceDescriptor [] 可用的接口。
chrome.desktopCapture
Updated 2024年11月25日
Desktop Capture API 可截取屏幕、单个窗口或单个标签页的内容。 用于定义 chooseDesktopMedia() 中使用的一组桌面媒体来源的枚举。 "screen" "window" "tab" "audio" 镜像 SelfCapturePreferenceEnum 。 "include" "exclude" 镜像 SystemAudioPreferenceEnum 。 "include" "exclude" 隐藏由 chooseDesktopMedia()
chrome.dns
Updated 2024年11月25日
使用 chrome.dns API 进行 DNS 解析。 如需使用此 API，您必须在 manifest 中声明 "dns" 权限。 以下代码调用 resolve() 以检索 example.com 的 IP 地址。 service-worker.js ： 字符串（选填） 表示 IP 地址字面量的字符串。仅当 resultCode 表示成功时才提供。 数值 结果代码。零表示成功。 解析给定的主机名或 IP 地址字面量。 字符串 要解析的主机名。 函数（可选） callback 参数如下所示：
chrome.declarativeContent
Updated 2024年11月25日
使用 chrome.declarativeContent API 可根据网页内容执行操作，而无需拥有读取网页内容的权限。 借助声明式内容 API，您可以根据网页的网址或 CSS 选择器是否与网页上的元素匹配来启用扩展程序的操作，而无需添加 主机权限 或注入 内容脚本 。 使用 activeTab 权限可在用户点击扩展程序的操作后与网页互动。 规则由条件和操作组成。如果满足其中任一条件，系统就会执行所有操作。相应操作分别为 setIcon() 和 showAction() 。
chrome.system.storage
Updated 2024年11月25日
使用 chrome.system.storage API 查询存储设备信息，并在可拆卸存储设备连接和断开连接时收到通知。 “success” 弹出命令已成功执行 - 应用可以提示用户移除设备。 "in_use" 设备正被其他应用使用。弹出操作未成功；在其他应用使用完设备之前，用户不应移除设备。 "no_such_device" 未知有此类设备。 “failure” 弹出命令失败。 数值 存储设备的可用容量（以字节为单位）。 字符串 getAvailableCapacity 函数参数 id 的复制
chrome.alarms
Updated 2024年11月25日
使用 chrome.alarms API 可安排代码定期运行或在未来的指定时间运行。 如需使用 chrome.alarms API，请在 manifest 中声明 "alarms" 权限： 为了确保可靠的行为，了解 API 的行为方式会很有帮助。 闹钟会在设备处于休眠状态时继续运行。不过，闹钟不会唤醒设备。设备唤醒后，所有错过的闹钟都会响铃。 重复闹钟最多会触发一次，然后系统会从设备唤醒时开始，使用指定的间隔时间重新安排闹钟，而不考虑闹钟最初设置为运行时已经经过的时间。
chrome.contextMenus
Updated 2024年11月25日
使用 chrome.contextMenus API 可向 Google Chrome 的上下文菜单添加项。您可以选择要将上下文菜单项应用于哪些类型的对象，例如图片、超链接和网页。 您必须在扩展程序的清单中声明 "contextMenus" 权限，才能使用该 API。此外，您还应指定一个 16 x 16 像素的图标，以便在菜单项旁边显示。例如： 上下文菜单项可显示在任何文档（或文档中的框架）中，即使是使用 file:// 或 chrome://
chrome.audio
Updated 2024年11月25日
chrome.audio API 的提供是为了让用户能够获取有关连接到系统的音频设备的信息并控制这些设备。此 API 目前仅适用于 ChromeOS 的自助服务终端模式。 字符串 设备名称。 DeviceType 设备类型。 字符串 简单易懂的名称（例如“USB 麦克风”）。 字符串 音频设备的唯一标识符。 布尔值 如果这是当前处于活动状态的设备，则为 true。 数值 设备的音量、输出音量、输入增益。 字符串（选填） 稳定/持久的设备 ID 字符串（如果有）。 StreamType
Autofill
Updated 2024年11月22日
浏览器和您作为开发者，都可以帮助用户更快地输入数据，并避免重复输入数据。 自动填充功能可让浏览器使用用户保存的信息（例如姓名、地址和付款详细信息）自动填充表单字段。了解自动填充功能的运作方式以及如何确保浏览器提供适当的自动填充选项，有助于用户节省大量时间和麻烦，并帮助他们避免出错。确保自动填充功能正常运行还有助于减少用户流失，从而提高表单提交率。 尤其是在商务和结账流程中，开发者发现自动填充功能对买方体验和商家成效有显著益处。 想要帮助用户快速轻松地从购物车进入付款流程？
chrome.declarativeNetRequest
Updated 2024年11月22日
chrome.declarativeNetRequest API 用于通过指定声明式规则来屏蔽或修改网络请求。这样，扩展程序就可以修改网络请求，而无需拦截和查看其内容，从而提供更高的隐私保护。 “ declarativeNetRequest ”和“ declarativeNetRequestWithHostAccess ”权限提供相同的功能。两者之间的区别在于请求或授予权限的时间。 除了前面介绍的权限之外，某些类型的规则集（尤其是静态规则集）还需要声明
chrome.devtools.panels
Updated 2024年11月22日
使用 chrome.devtools.panels API 将您的扩展程序集成到“开发者工具”窗口界面：创建自己的面板、访问现有面板以及添加边栏。 每个扩展程序面板和边栏都会显示为单独的 HTML 页面。“开发者工具”窗口中显示的所有扩展程序页面都可以访问 chrome.devtools API 的所有部分，以及所有其他扩展程序 API。 您可以使用 devtools.panels.setOpenResourceHandler
chrome.fileBrowserHandler
Updated 2024年11月22日
使用 chrome.fileBrowserHandler API 扩展 ChromeOS 文件浏览器。例如，您可以使用此 API 让用户将文件上传到您的网站。 当用户按 Alt+Shift+M 或连接外部存储设备（例如 SD 卡、USB 密钥、外部驱动器或数码相机）时，ChromeOS 文件浏览器就会弹出。除了显示外部设备上的文件外，文件浏览器还可以显示用户之前保存到系统中的文件。
chrome.readingList
Updated 2024年11月21日
使用 chrome.readingList API 读取和修改 阅读清单 中的项。 如需使用阅读列表 API，请在扩展程序 manifest 文件中添加 "readingList" 权限： manifest.json: Chrome 的侧边栏中提供了阅读清单。借助该功能，用户可以保存网页以供日后阅读或离线阅读。使用 Reading List API 检索现有内容，并在列表中添加或移除内容。 阅读列表中的项目没有固定的顺序。 项按网址键值对进行排序。其中包括哈希和查询字符串。 以下部分展示了
视频无障碍功能荣获 Gemini API 开发者大赛 Web 类奖项
Updated 2024年11月21日
我们已将 ViddyScribe 评选为 Gemini API 开发者大赛 Web 类奖项的获奖者。他们展示了 Gemini 如何通过为任何视频生成音频描述，帮助提高网页上视频的无障碍性。
chrome.networking.onc
Updated 2024年11月14日
chrome.networking.onc API 用于配置网络连接（移动网络、以太网、VPN 或 Wi-Fi）。此 API 适用于自动启动的 ChromeOS 自助服务终端会话。 网络连接配置是按照 Open Network Configuration (ONC) 规范指定的。 注意 ：大多数字典属性和枚举值使用 UpperCamelCase 命名法，以符合 ONC 规范，而不是使用 JavaScript 的 lowerCamelCase 惯例。 “已启用” “正在激活”
使用 Signal API 确保通行密钥与服务器上的凭据保持一致
Updated 2024年11月12日
借助 WebAuthn Signal API，依赖方可以向通行密钥提供程序发送现有凭据的状态信号，以便通行密钥与服务器上的凭据保持一致。
加入 Chrome 扩展程序 Prompt API 源试用
Updated 2024年11月12日
参与 Chrome 扩展程序 Prompt API 源试用，并在 Chrome 中使用 Gemini Nano。
WebGPU 的新变化 (Chrome 131)
Updated 2024年11月6日
WGSL 中的剪裁距离、GPUCanvasContext getConfiguration()、点和线基元不得有深度偏差、针对子组的包含扫描内置函数、对多绘制间接的实验性支持、着色器模块编译选项严格数学、移除 GPUAdapter requestAdapterInfo() 等。
通过无缝的凭据共享功能，帮助用户顺畅登录
Updated 2024年11月4日
借助无缝凭据共享功能，您可以安全地向密码管理工具发出信号，让用户能够在您的 Android 应用和网站中使用相同的凭据登录。
Chrome 开发者工具 (Chrome 131) 的新变化
Updated 2024年10月30日
使用 Gemini 调试 CSS，在“性能”面板中添加注释和获取数据洞见，发现过度布局偏移和非合成动画等问题。
从 Chrome 中移除 --headless=old
Updated 2024年10月23日
Chrome 132 不再包含旧版无头模式。迁移到 chrome-headless-shell 或新版无头模式。
为 Cache-Control: no-store 启用 bfcache
Updated 2024年10月21日
Chrome 将进行一项更改，允许在确保安全的情况下，对使用 Cache-Control: no-store 的网页使用 bfcache 功能。了解这对开发者意味着什么。
API 参考
Updated 2024年10月15日
针对 Chrome 扩展程序可用的所有 API 的完整参考。这包括适用于已弃用的 Chrome 应用平台的 API，以及仍在测试和开发阶段的 API。
Chrome 130
Updated 2024年10月15日
Chrome 130 现已发布！文档画中画功能可让您更好地控制画中画窗口，CSS 嵌套声明可修复一些棘手的边缘情况，您还可以指定分布在多行中的元素上的装饰的行为方式，还有更多功能！
Chrome 130 中的新变化
Updated 2024年10月15日
Chrome 130 现已发布！文档画中画可让您更好地控制画中画窗口，CSS 嵌套声明可修复一些棘手的边缘情况，您还可以指定分布在多行中的元素上的装饰的行为方式。Pete LePage 详细介绍了 Chrome 130 中面向开发者的新功能。
WebGPU（Chrome 130）中的新变化
Updated 2024年10月15日
双源混合、缩短了 Metal 的着色器编译时间、废弃了 GPUAdapter requestAdapterInfo() 等等。
chrome.virtualKeyboard
Updated 2024年10月14日
chrome.virtualKeyboard API 是仅限自助服务终端的 API，用于配置自助服务终端会话中虚拟键盘布局和行为。 布尔值（可选） 虚拟键盘能否提供自动补全功能。 布尔值（可选） 虚拟键盘能否提供自动更正功能。 布尔值（可选） 虚拟键盘是否可以通过手写识别来提供输入。 布尔值（可选） 虚拟键盘能否提供拼写检查功能。 布尔值（可选） 虚拟键盘是否可以提供语音输入。 设置对虚拟键盘提供的功能的限制。 FeatureRestrictions 启用/停用虚拟键盘功能的偏好设置。
chrome.clipboard
Updated 2024年10月14日
chrome.clipboard API 旨在允许用户访问剪贴板中的数据。这是针对 chromeos 平台应用的临时解决方案，直到开放网络替代方案推出为止。开放网络解决方案推出后（可能在 2017 年第 4 季度推出），它将弃用。 字符串 附加数据项的内容。如果 type 为“textPlain”，则为纯文本字符串或标记字符串（如果 type 为“textHTML”）。数据大小不得超过 2 MB。 DataItemType 其他数据项的类型。 "textPlain" "textHTML"
Long Animation Frames API
Updated 2024年10月14日
了解 Long Animation Frames API (LoAF)，该 API 是 Long Tasks API 的下一代迭代版本，支持通过归因衡量帧更新延迟
加入 Google Chrome 内置 AI 挑战赛
Updated 2024年10月1日
我们将举办内置 AI 挑战赛，诚邀您重新思考如何在 Chrome 中使用 Gemini Nano 实现各种可能。
Chrome 130 开发者工具的新变化
Updated 2024年9月30日
针对您可以在“效果”面板中浏览的实时指标和面包屑导航功能提供建议，改进了网络过滤条件，提供经过净化处理的 HAR 导出内容等。
提升 Chrome 应用商店开发者信息中心的移动体验
Updated 2024年9月30日
我们很高兴推出一组界面变更，使 Chrome 应用商店开发者信息中心的响应速度更快，更适合移动设备。我们希望这样能让您在监控商品详情效果、更改商品详情以及管理实体店内扩展程序时获得更便捷的体验。 我们更新了所有图表和分析页面，使其更具响应能力，以便您更好地查看扩展程序在移动设备上的商品详情效果。 您还可以通过移动设备更新商店元数据，包括说明、图片和隐私设置。
Web Vitals 扩展程序现已在 DevTools 中推出
Updated 2024年9月24日
Web Vitals 扩展程序将与 Chrome DevTools 的“性能”面板合并，并于 2025 年 1 月停用独立支持。
使用 Web 应用清单 ID 属性对 PWA 进行唯一标识
Updated 2024年9月20日
可选的 `id` 属性是 Web 应用清单规范的一部分，可让您明确定义用于 PWA 的标识符。向清单添加 `id` 属性会移除对 `start_url` 或清单位置的依赖，以便日后更新这些属性。
Chrome：用于在桌面设备和 Android 设备之间同步 Google 密码管理工具中的通行密钥
Updated 2024年9月19日
桌面版 Chrome 很快将能够在 Google 密码管理工具 (GPM) 中创建通行密钥，并在 Android 之外的其他平台上同步这些通行密钥。
在开发者工具中监控本地和真实用户的 Core Web Vitals 性能
Updated 2024年9月17日
Chrome 开发者工具中的“性能”面板提供了一种新的方式来监控本地 Core Web Vitals 性能，并将其与实际用户数据进行比较。
Chrome 129 中的新变化
Updated 2024年9月17日
Chrome 129 现已发布！长任务可以产生 - 为了提高性能，您可以为具有固有大小的元素添加动画效果，对锚点定位语法进行一些更改，等等。Pete LePage 详细介绍了 Chrome 129 中面向开发者的新功能。
键盘锁定 API 和 Pointer Lock API 需要从 Chrome 131 获得权限
Updated 2024年9月10日
借助 Keyboard Lock API ，开发者可以为各种用例（包括互动网站、游戏以及远程桌面或应用流式传输）提供沉浸式全屏体验。它通过允许网站使用主机操作系统允许的所有可用按键来实现此目的。 借助 Pointer Lock API ，桌面应用可以隐藏指针图标，并将鼠标移动解释为其他操作，例如在 3D 世界中环顾四周。 从 Chrome 131 开始，使用这两个 API 都需要权限。您可以 检查 权限，如以下代码段所示： 无需明确 请求
内存检查器：检查 ArrayBuffer、TypedArray、DataView 和 Wasm 内存。
Updated 2024年9月6日
使用内存检查器可在 JavaScript 以及 WebAssembly.Memory of C++ Wasm 应用中检查 ArrayBuffer、TypedArray 或 DataView。
隆重推出 Digital Credentials API 源试用
Updated 2024年9月4日
Digital Credentials API 的源试用将从 Chrome 128 开始。Digital Credentials API 是一种新的网络平台 API，可让网站通过数字凭据（例如存储在数字钱包中的驾照或国民身份证）选择性地请求有关用户的可验证信息。
在 Chrome 中实现跨网站无缝共享凭据的功能
Updated 2024年9月4日
如果您使用多个网域共用同一个账号管理后端，那么现在通过 Digital Asset Links，您还可以在这些网域之间无缝共享凭据。这样一来，用户只需保存一次凭据，即可让 Chrome 密码管理器将这些凭据推荐给任何关联的网站。
Chrome 129 开发者工具中的新功能
Updated 2024年9月2日
“效果”>“搜索请求”网络、通过自动填充功能在地址表单中使用测试数据、在“记录器”面板中导出到适用于 Firefox 的 Puppeteer，以及通过“性能”面板中的观察结果一目了然地发现性能问题，等等。
隆重推出适用于 Chrome 中的 WebAuthn 的提示、相关源请求和 JSON 序列化
Updated 2024年8月30日
Chrome 上的 WebAuthn 现在可以使用提示、相关源请求和 JSON 序列化
chrome.webRequest
Updated 2024年8月23日
使用 chrome.webRequest API 可观察和分析流量，以及拦截、阻止或修改传输中的请求。 您必须在 扩展程序清单 中声明 "webRequest" 权限，才能使用 Web 请求 API 以及必要的 主机权限 。要拦截子资源请求， 扩展程序必须同时有权访问请求的网址及其发起者。例如： webRequestBlocking 必须填写此字段，才能注册屏蔽事件处理脚本。从 Manifest V3 开始， 适用于通过政策安装的扩展程序 webRequestAuthProvider 使用
chrome.sidePanel
Updated 2024年8月23日
使用 chrome.sidePanel API 可将浏览器侧边栏中的内容与网页的主要内容一同托管。 如需使用 Side Panel API，请在扩展程序 清单 文件中添加 "sidePanel" 权限： manifest.json: 借助 Side Panel API，扩展程序可以在侧边栏中显示自己的界面，从而提供持久的体验，补充用户的浏览历程。 部分功能包括： 以下部分介绍了 Side Panel API 的一些常见用例。如需查看完整的扩展程序示例，请参阅 扩展程序示例 。 最初可通过清单的
chrome.omnibox
Updated 2024年8月23日
多功能框 API 可让您向 Chrome 浏览器的地址栏（也称为多功能框）注册关键字。 当该用户输入您扩展程序中的关键字后，便开始只与您的 。每次按键操作都会发送到您的扩展程序，并且您可以在响应中提供建议。 建议可以采用多种格式以各种格式进行显示。当用户接受建议后 您的扩展程序会收到通知，并可以采取相应措施。 您必须在 清单 中添加 omnibox keyword 字段，才能使用多功能框 API。您 还应该指定一个 16x16
chrome.pageAction
Updated 2024年8月23日
使用 chrome.pageAction API 将图标放置在 Google Chrome 主工具栏（地址栏右侧）中。网页操作是指可对当前网页执行，但并不适用于所有网页的操作。处于非活动状态的页面操作会显示为灰色。 一些示例： 以下屏幕截图中的 RSS 图标代表可让您订阅 RSS 的页面操作 Feed。 隐藏的网页操作会显示为灰色。例如，下面的 RSS Feed 是灰显的， 订阅当前页面的 Feed： 请考虑改用 浏览器操作 ，以便用户始终与您的 。 在 扩展程序清单
chrome.windows
Updated 2024年8月23日
使用 chrome.windows API 与浏览器窗口进行交互。您可以使用此 API 在浏览器中创建、修改和重新排列窗口。 收到请求时， windows.Window 会包含一组 tabs.Tab 对象。您必须 如果您需要访问 url ，请在 清单 中声明 "tabs" 权限， tabs.Tab 的 pendingUrl 、 title 或 favIconUrl 属性。例如： 扩展系统中的许多函数都接受可选的 windowId 参数，该参数默认为 。
chrome.i18n
Updated 2024年8月23日
使用 chrome.i18n 基础架构在您的整个应用或扩展程序中实现国际化。 您需要将其所有的用户可见字符串都放入名为 messages.json 的文件中。每次 添加新的语言区域时，请在名为 _locales/_localeCode_ 的目录下添加消息文件，其中 localeCode 是一个代码，例如表示英语的 en 。 以下是支持英语 ( en )、西班牙语的国际化扩展程序的文件层次结构 ( es ) 和韩语 ( ko )： 假设您的扩展程序包含如下图所示的文件：
chrome.browserAction
Updated 2024年8月23日
使用浏览器操作将图标放入 Google Chrome 主工具栏（位于地址栏的右侧）。除了 图标 之外，浏览器操作还可以包含 提示 、 标记 和 弹出式窗口 。 在下图中，地址栏右侧的彩色方块是 。图标下方会显示一个弹出式窗口。 如果您想创建的图标不是始终处于活跃状态，请使用 网页操作 （而不是浏览器） 操作。 在 扩展程序清单 中注册浏览器操作，如下所示： 您可以提供任意尺寸的图标，以便在 Chrome 中使用，Chrome 会选择最接近的图标并进行缩放 将其调整为适当的尺寸，以填充
chrome.webRequest
Updated 2024年8月23日
使用 chrome.webRequest API 可观察和分析流量，以及拦截、阻止或修改传输中的请求。 您必须在 扩展程序清单 中声明 "webRequest" 权限，才能使用 Web 请求 API 以及必要的 主机权限 。要拦截子资源请求， 扩展程序必须同时有权访问请求的网址及其发起者。例如： 从 Chrome 108 开始，如果您使用 "webRequest" 和 "webRequestAuthProvider" ，则可以为 onAuthRequired 事件 异步提供凭据 权限。 Web
chrome.fileBrowserHandler
Updated 2024年8月23日
使用 chrome.fileBrowserHandler API 扩展 Chrome 操作系统的文件浏览器。例如，您可以使用此 API 让用户向您的网站上传文件。 当用户按 Alt+Shift+M 或连接外部存储设备（例如 SD 卡、USB 密钥、外部驱动器或数码相机）时，ChromeOS 文件浏览器将会启动。除了显示外部设备上的文件外，文件浏览器还可以显示用户之前保存到系统的文件。
chrome.devtools.panels
Updated 2024年8月23日
使用 chrome.devtools.panels API 将您的扩展程序集成到开发者工具窗口界面中：创建自己的面板、访问现有面板以及添加边栏。 必须在 清单 中声明以下键才能使用此 API。 有关使用开发者工具 API 的一般说明，请参阅 DevTools API 摘要 。 每个扩展程序面板和边栏都会显示为一个单独的 HTML 网页。已显示所有扩展程序页面 在“开发者工具”窗口中可以访问 chrome.devtools API 中的所有模块，以及 chrome.extension
chrome.system.cpu
Updated 2024年8月23日
使用 system.cpu API 查询 CPU 元数据。 字符串 处理器的架构名称。 字符串[] 一组功能代码，用于表示处理器的部分功能。目前支持的代码包括“mmx”“sse”“sse2”“sse3”“ssse3”“sse4_1”“sse4_2”和“avx”。 字符串 处理器的型号名称。 number 逻辑处理器数量。 ProcessorInfo [] 每个逻辑处理器的相关信息。 数值 [] 来自 CPU 每个热区的 CPU 温度读数列表。温度以摄氏度为单位。 目前仅适用于 ChromeOS。
chrome.enterprise.networkingAttributes
Updated 2024年8月23日
使用 chrome.enterprise.networkingAttributes API 读取有关当前网络的信息。注意：此 API 仅适用于由企业政策强制安装的扩展程序。 字符串（可选） 设备的本地 IPv4 地址（如果未配置，则未定义）。 字符串（可选） 设备的本地 IPv6 地址（如果未配置，则未定义）。 字符串 设备的 MAC 地址。 检索设备默认网络的网络详细信息。如果用户未关联或设备未连接到网络，系统将设置 runtime.lastError 并注明失败原因。 函数（可选）
chrome.input.ime
Updated 2024年8月23日
使用 chrome.input.ime API 为 ChromeOS 实现自定义 IME。这样一来，您的扩展程序就可以处理按键、设置构图和管理候选窗口。 您必须声明“input”权限，以使用 input.ime API。 例如： 以下代码会创建一个 IME，用于将输入的字母转换为大写。 辅助窗口中按钮的 ID。 "撤消" "addToDictionary" 辅助窗口的属性。 字符串（可选） ChromeVox 朗读的字符串。 "撤消" 布尔值 设为 true 以显示
chrome.instanceID
Updated 2024年8月23日
使用 chrome.instanceID 访问实例 ID 服务。 重置应用实例标识符并撤消与其关联的所有令牌。 函数（可选） callback 参数如下所示： 承诺<void> 只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。 撤消已授予的令牌。 对象 deleteToken 的参数。 字符串 用于获取令牌的授权实体。 字符串 用于获取令牌的范围。 函数（可选） callback 参数如下所示： 承诺<void> 只有 Manifest
chrome.gcm
Updated 2024年8月23日
使用 chrome.gcm 可让应用和扩展程序通过 Firebase Cloud Messaging (FCM) 发送和接收消息。 消息中所有键值对的大小上限（以字节为单位）。 4096 向 FCM 注册该应用。 callback 将返回注册 ID。如果使用同一 senderIds 列表再次调用 register ，则会返回相同的注册 ID。 字符串[] 允许向应用发送消息的服务器 ID 列表。其中应包含至少 1 个发送者 ID，但不得超过 100 个。 函数（可选） callback
chrome.loginState
Updated 2024年8月23日
使用 chrome.loginState API 读取和监控登录状态。 "SIGNIN_PROFILE" 指定扩展程序在登录个人资料中。 "USER_PROFILE" 指定扩展程序在用户个人资料中。 "UNKNOWN" 指定会话状态未知。 "IN_OOBE_SCREEN" 指定用户处于开箱体验屏幕。 "IN_LOGIN_SCREEN" 指定用户正处于登录屏幕。 "IN_SESSION" 指定用户正在会话中。 "IN_LOCK_SCREEN" 指定用户位于锁定屏幕中。
chrome.fontSettings
Updated 2024年8月23日
使用 chrome.fontSettings API 管理 Chrome 的字体设置。 要使用 Font Settings API，您必须声明“fontSettings”权限 清单 。例如： Chrome 允许某些字体设置取决于特定的常规字体系列和语言 脚本。例如， sans-serif 简体中文使用的字体可能与该字体不同 用于 serif 日语。 Chrome 支持的通用字体系列基于 CSS 通用字体系列 ， 。如果网页指定了通用字体系列，Chrome
chrome.printingMetrics
Updated 2024年8月23日
使用 chrome.printingMetrics API 提取有关打印使用情况的数据。 "BLACK_AND_WHITE" 指定使用黑白模式。 "COLOR" 指定使用了颜色模式。 "ONE_SIDED" 指定使用单面打印。 &quot;TWO_SIDED_LONG_EDGE&quot; 指定使用双面打印，将长边翻转。 &quot;TWO_SIDED_SHORT_EDGE&quot; 指定使用双面打印，短边翻转。 number 打印介质的高度（以微米为单位）。
chrome.processes
Updated 2024年8月23日
使用 chrome.processes API 与浏览器的进程进行交互。 number 使用的缓存部分（以字节为单位）。 number 缓存的大小（以字节为单位）。 编号（ 选填 ） 最近测量的进程 CPU 使用率，表示为进程的所有线程使用的单个 CPU 核心所占的百分比。这会得到一个介于 0 到 CpuInfo.numOfProcessors*100 之间的值，在多线程进程中，该值可以超过 100%。仅当作为 onUpdated 或 onUpdatedWithMemory
chrome.platformKeys
Updated 2024年8月23日
使用 chrome.platformKeys API 访问由平台管理的客户端证书。如果用户或政策授予了此权限，扩展程序便可在其自定义身份验证协议中使用此类证书。例如：这允许在第三方 VPN 中使用平台管理的证书（请参阅 chrome.vpnProvider ）。 ArrayBuffer[] 服务器允许的证书授权机构的标识名列表。每个条目都必须是 DER 编码的 X.509 DistinguishedName。 ClientCertificateType []
chrome.devtools.inspectedWindow
Updated 2024年8月23日
使用 chrome.devtools.inspectedWindow API 与检查的窗口进行交互：获取被检查页面的标签页 ID、在被检查的窗口中评估代码、重新加载页面或者获取页面中的资源列表。 必须在 清单 中声明以下键才能使用此 API。 使用 chrome.devtools.inspectedWindow 与检查的窗口进行交互：获取用于 在检查窗口中评估代码、重新加载页面或获取 该页面内的资源列表。 有关使用开发者工具 API 的一般说明，请参阅 DevTools API 摘要 。
chrome.history
Updated 2024年8月23日
使用 chrome.history API 与浏览器的已访问网页的记录进行交互。您可以在浏览器的历史记录中添加、移除和查询网址。如需使用您自己的版本替换历史记录页面，请参阅 覆盖网页 。 您必须声明“历史记录”权限，以便使用 History API。 例如： History API 使用 过渡类型 来描述浏览器如何导航到特定网址 。例如，如果用户通过点击其他网页上的链接访问了某个网页， 为“link” 下表介绍了每种过渡类型。 若要试用此 API，请安装
chrome.identity
Updated 2024年8月23日
使用 chrome.identity API 获取 OAuth2 访问令牌。 字符串 账号的唯一标识符。在账号的整个有效期内，此 ID 不会发生变化。 "SYNC" 指定为主账号启用同步功能。 "ANY" 指定是否存在主账号（如果有）。 string[] 选填 向扩展程序授予的 OAuth2 范围列表。 字符串（可选） 与请求关联的特定令牌。 字符串 应从缓存中移除的特定令牌。 AccountStatus 可选 登录到个人资料的主账号的状态，该个人资料的 ProfileUserInfo
chrome.tts
Updated 2024年8月23日
使用 chrome.tts API 播放合成的文字转语音 (TTS)。另请参阅相关的 ttsEngine API，该 API 允许扩展程序实现语音引擎。 Chrome 为 Windows（使用 SAPI 5）、Mac OS X 和 ChromeOS 上的语音提供原生支持，使用 语音合成功能。在所有平台上，用户都可以 安装会自行注册为备用语音引擎的扩展程序。 通过分机拨打 speak() 开始说话。例如： 要立即停止说话，只需调用 stop() 即可：
chrome.devtools.recorder
Updated 2024年8月23日
使用 chrome.devtools.recorder API 自定义开发者工具中的“Recorder”面板。 有关使用开发者工具 API 的一般说明，请参阅 DevTools API 摘要 。 devtools.recorder API 是一项预览版功能，可让您扩展 Chrome 开发者工具中的 Recorder 面板 。 从 Chrome M105 开始，您可以扩展导出功能。从 Chrome M112 开始，您可以延长重放按钮。 如需注册扩展插件，请使用
chrome.enterprise.hardwarePlatform
Updated 2024年8月23日
使用 chrome.enterprise.hardwarePlatform API 获取运行浏览器的硬件平台的制造商和型号。注意：此 API 仅适用于由企业政策安装的扩展程序。 字符串 字符串 获取硬件平台的制造商和型号，如果扩展程序获得授权，则会通过 callback 返回。 函数（可选） callback 参数如下所示： HardwarePlatformInfo Promise&lt; HardwarePlatformInfo &gt; 只有 Manifest V3
chrome.dom
Updated 2024年8月23日
使用 chrome.dom API 访问适用于扩展程序的特殊 DOM API 获取由指定元素托管的打开的影子根或封闭的影子根。如果该元素未附加影子根，它将返回 null。 HTMLElement 对象 请参阅 https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot
chrome.tabCapture
Updated 2024年8月23日
使用 chrome.tabCapture API 与标签页媒体流进行交互。 借助 chrome.tabCapture API，您可以访问包含视频和媒体内容的 MediaStream 。 当前标签页的音频。只有在用户调用扩展程序后才能调用该方法，例如通过 该扩展程序的 操作按钮 即可。这类似于 activeTab 权限。 为某个标签页获取 MediaStream 后，该标签页中的音频将不再播放 。这与 getDisplayMedia() 函数在以下情况的行为类似：
chrome.management
Updated 2024年8月23日
chrome.management API 提供了多种方法来管理已安装的应用和扩展程序。 您必须声明“management” 扩展程序清单 中的权限，以使用管理功能 API。例如： management.getPermissionWarningsByManifest 、 management.uninstallSelf 和 management.getSelf 无需管理权限。 该项被停用的原因。 “未知” &quot;permissions_increase&quot;
chrome.webNavigation
Updated 2024年8月23日
使用 chrome.webNavigation API 接收有关飞行中导航请求状态的通知。 所有 chrome.webNavigation 方法和事件都需要您声明“webNavigation”权限 在 扩展程序清单 中。例如： 对于成功完成的导航，系统会按以下顺序触发事件： 此过程过程中发生的任何错误都会导致 onErrorOccurred 事件。对于特定的 导航时，在 onErrorOccurred 后不再触发其他事件。 如果导航帧包含子帧，其 onCommitted
chrome.topSites
Updated 2024年8月23日
使用 chrome.topSites API 访问新标签页上显示的热门网站（即最常访问的网站）。这些不包括用户自定义的快捷方式。 您必须声明“topSites” 扩展程序清单 中授予使用此 API 的权限。 若要试用此 API，请安装 chrome-extension-samples 中的 topSites API 示例 存储库 用于封装最常访问的网址（例如新标签页上的默认快捷方式）的对象。 字符串 网页的标题 字符串 最常访问的网址。 获取热门网站列表。 函数（可选） callback
chrome.windows
Updated 2024年8月23日
使用 chrome.windows API 与浏览器窗口进行交互。您可以使用此 API 在浏览器中创建、修改和重新排列窗口。 收到请求时， windows.Window 会包含一组 tabs.Tab 对象。您必须 如果您需要访问 url ，请在 清单 中声明 "tabs" 权限， tabs.Tab 的 pendingUrl 、 title 或 favIconUrl 属性。例如： 扩展系统中的许多函数都接受可选的 windowId 参数，该参数默认为 。
chrome.search
Updated 2024年8月23日
使用 chrome.search API 通过默认提供程序进行搜索。 "CURRENT_TAB" 指定搜索结果显示在发起调用的标签页中或当前所用浏览器的标签页中。 "NEW_TAB" 指定搜索结果显示在新标签页中。 "NEW_WINDOW" 指定搜索结果在新窗口中打开。 Disposition （可选） 应显示搜索结果的位置。默认为 CURRENT_TAB 。 编号（ 选填 ） 应显示搜索结果的位置。 tabId 不能与 disposition 一起使用。 字符串
chrome.idle
Updated 2024年8月23日
使用 chrome.idle API 检测机器的空闲状态何时发生变化。 你必须声明“idle”权限，以使用闲置 API。例如： "有效" "idle" "已锁定" 获取屏幕在闲置时自动锁定所用的时间（以秒为单位）。如果屏幕从不自动锁定，则返回时长为零。目前仅适用于 ChromeOS。 函数（可选） callback 参数如下所示： number 屏幕在闲置时自动锁定所用的时间（以秒为单位）。如果屏幕永不自动锁定，则此值为零。 Promise&lt;number&gt; 只有
chrome.types
Updated 2024年8月23日
chrome.types API 包含 Chrome 的类型声明。 ChromeSetting 原型提供了一组常用的函数（ get() 、 set() 和 clear() ） 以及 Chrome 浏览器设置的事件发布者 ( onChange )。 代理设置 示例 演示了这些函数的预期用途。 Chrome 可区分浏览器设置的三种不同范围： Chrome 管理不同图层上的设置。以下列表介绍了可 影响有效设置（按优先顺序由高到低）。
chrome.wallpaper
Updated 2024年8月23日
使用 chrome.wallpaper API 更改 ChromeOS 壁纸。 您必须声明“壁纸”权限，以便使用 壁纸 API。例如： 例如，要将壁纸设为 https://example.com/a_file.png ，你可以拨打 chrome.wallpaper.setWallpaper 。 支持的壁纸版式。 “STRETCH” "CENTER" "CENTER_CROPPED" 将壁纸设置为位于 url 或 wallpaperData 且具有指定的 layout 的图片 对象
chrome.enterprise.deviceAttributes
Updated 2024年8月23日
使用 chrome.enterprise.deviceAttributes API 读取设备属性。注意：此 API 仅适用于由企业政策强制安装的扩展程序。 获取管理员注释的营业地点。如果当前用户未关联或管理员未设置任何注释位置，则返回空字符串。 函数（可选） callback 参数如下所示： 字符串 承诺<字符串> 只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。 获取管理员注释的资产 ID。如果当前用户未关联或管理员尚未设置资产
chrome.privacy
Updated 2024年8月23日
您可以使用 chrome.privacy API 控制 Chrome 中可能会影响用户隐私的功能的使用情况。此 API 依赖 ChromeSetting 类型 API 的原型 来获取和设置 Chrome 的配置。 您必须声明“隐私”权限，才能使用该 API。 例如： 读取 Chrome 设置的当前值非常简单。您首先需要找到 属性，那么您将需要对该对象调用 get() ，以检索其 当前值以及您的扩展程序的控制级别。例如，确定 Chrome 的自动填充功能是否 您需要编写：
chrome.systemLog
Updated 2024年8月23日
使用 chrome.systemLog API 记录扩展程序中的 Chrome 系统日志。 字符串 添加新的日志记录。 MessageOptions 日志记录选项。 函数（可选） callback 参数如下所示： 承诺<void> 只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
chrome.pageCapture
Updated 2024年8月23日
使用 chrome.pageCapture API 可将标签页保存为 MHTML。 MHTML 是大多数浏览器支持的 标准格式 。它将页面封装在单个文件中 及其所有资源（CSS 文件、图片...） 请注意，出于安全考虑，MHTML 文件只能从文件系统加载，而且 只能在主框架中加载 您必须声明“pageCapture”权限，以使用 pageCapture API。例如： 将具有指定 ID 的标签页的内容保存为 MHTML。 对象 number 要另存为 MHTML 的标签页的 ID。 函数（可选）
chrome.fileSystemProvider
Updated 2024年8月23日
您可以使用 chrome.fileSystemProvider API 创建可通过 Chrome 操作系统的文件管理器访问的文件系统。 您必须声明“fileSystemProvider”权限和 扩展程序清单 中的部分，以便使用 File System Provider API。例如： file_system_provider 部分必须声明如下： “文件”应用使用上述信息来适当呈现相关的界面元素。例如，如果 configurable 设置为 true，则系统会呈现用于配置卷的菜单项。同样，如果
chrome.notifications
Updated 2024年8月23日
借助 chrome.notifications API，您可以使用模板创建内容丰富的通知，并在系统任务栏中向用户显示这些通知。 字符串（可选） 按钮图标对 Mac OS X 用户不可见。 字符串 字符串 关于此内容的其他详细信息。 字符串 列表通知中一项的标题。 字符串（可选） Mac OS X 用户看不到应用图标遮罩。 指向应用图标遮罩的网址。网址与 iconUrl 具有相同的限制。 应用图标遮罩应采用 alpha 通道，因为系统只会考虑图片的 alpha 通道。
chrome.power
Updated 2024年8月23日
使用 chrome.power API 替换系统的电源管理功能。 默认情况下，当用户不活动时，操作系统会调暗屏幕，并最终暂停 系统。借助 Power API，应用或扩展程序可使系统保持唤醒状态。 使用此 API，您可以指定要停用电源管理的 Level 。 "system" 使系统保持活动状态，但允许调暗或关闭屏幕。例如， 通信应用在屏幕关闭时继续接收消息。 "display" 级别 使屏幕和系统保持活动状态例如，电子书和演示文稿应用 和系统处于活动状态。
chrome.downloads
Updated 2024年8月23日
此权限 会触发警告 使用 chrome.downloads API 以编程方式启动、监控、操作和搜索下载内容。 您必须在 扩展程序清单 中声明 "downloads" 权限，才能使用此 API。 您可以在 examples/api/downloads 中找到使用 chrome.downloads API 的简单示例 目录。如需获取其他示例以及查看源代码方面的帮助，请参阅 示例 。 布尔值（可选） 布尔值（可选） 文件 下载内容的文件名可疑。 网址 已知下载内容的网址是恶意网址。 内容
chrome.devtools.network
Updated 2024年8月23日
使用 chrome.devtools.network API 检索由开发者工具在“Network”面板中显示的网络请求的相关信息。 必须在 清单 中声明以下键才能使用此 API。 有关使用开发者工具 API 的一般说明，请参阅 DevTools API 摘要 。 网络请求信息以 HTTP 归档格式 ( HAR ) 表示。以下各项的说明： HAR 不在本文档的介绍范围内，请参阅 HAR v1.2 规范 。 对于 HAR， chrome.devtools.network.getHAR()
chrome.vpnProvider
Updated 2024年8月23日
使用 chrome.vpnProvider API 实现 VPN 客户端。 vpnProvider 的典型用法如下： 使用 createConfig 方法创建 VPN 配置。VPN 配置是在原生 ChromeOS 界面中向用户显示的永久条目。用户可以从列表中选择 VPN 配置，然后连接到该配置或断开该配置。 为 onPlatformMessage 、 onPacketReceived 和 onConfigRemoved 事件添加监听器。 当用户连接到 VPN 配置时，会收到
chrome.proxy
Updated 2024年8月23日
使用 chrome.proxy API 管理 Chrome 的代理设置。此 API 依赖 ChromeSetting 类型 API 原型 来获取和设置代理配置。 您必须声明“代理”权限，以使用代理设置 API。例如： 代理设置在 proxy.ProxyConfig 对象中定义。根据 Chrome 的代理设置， 这些设置可能包含 proxy.ProxyRules 或 proxy.PacScript 。 ProxyConfig 对象的 mode 属性决定了 Chrome
chrome.printerProvider
Updated 2024年8月23日
chrome.printerProvider API 公开了打印管理器用于查询由扩展程序控制的打印机、查询其功能以及向这些打印机提交打印作业的事件。 字符串（可选） 打印机的直观易懂的说明。 字符串 唯一打印机 ID。 字符串 打印机的人类可读名称。 为响应 onPrintRequested 事件而返回的错误代码。 "OK" 表示操作已成功完成。 "FAILED" 表示发生了常规故障。 "INVALID_TICKET"
chrome.events
Updated 2024年8月23日
chrome.events 命名空间包含一些常用类型，API 会使用这些类型来调度事件，以便在发生值得注意的事情时通知您。 Event 是一个对象，可让您在发生有趣的事情时收到通知。这里有 使用 chrome.alarms.onAlarm 事件在闹钟经过时接收通知的示例： 如示例所示，您将使用 addListener() 注册接收通知。用于 addListener() 始终是您定义的用于处理事件的函数， 函数取决于您正在处理的事件。查看 alarms.onAlarm
chrome.events
Updated 2024年8月22日
chrome.events 命名空间包含一些常用类型，API 会使用这些类型来调度事件，以便在发生值得注意的事情时通知您。 Event 是一个对象，可让您在发生有趣的事情时收到通知。这里有 使用 chrome.alarms.onAlarm 事件在闹钟经过时接收通知的示例： 如示例所示，您将使用 addListener() 注册接收通知。用于 addListener() 始终是您定义的用于处理事件的函数， 函数取决于您正在处理的事件。查看 alarms.onAlarm
chrome.dom
Updated 2024年8月22日
使用 chrome.dom API 访问适用于扩展程序的特殊 DOM API 获取由指定元素托管的打开的影子根或封闭的影子根。如果该元素未附加影子根，它将返回 null。 HTMLElement 对象 请参阅 https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot
chrome.omnibox
Updated 2024年8月22日
多功能框 API 可让您向 Chrome 浏览器的地址栏（也称为多功能框）注册关键字。 当该用户输入您扩展程序中的关键字后，便开始只与您的 。每次按键操作都会发送到您的扩展程序，并且您可以在响应中提供建议。 建议可以采用多种格式以各种格式进行显示。当用户接受建议后 您的扩展程序会收到通知，并可以采取相应措施。 必须在 清单 中声明以下键才能使用此 API。 您必须在 清单 中添加 "omnibox.keyword" 字段，才能使用多功能框 API。您 还应该指定一个 16 x 16
chrome.sockets.tcp
Updated 2024年8月22日
使用 chrome.sockets.tcp API，通过 TCP 连接通过网络发送和接收数据。此 API 会取代之前在 chrome.socket API 中提供的 TCP 功能。 必须在 清单 中声明以下键才能使用此 API。 number 新创建的套接字的 ID。请注意，通过此 API 创建的套接字 ID 与其他 API（例如已弃用的 [ socket ](../socket/) API）创建的套接字 ID 不兼容。 DNS 解析偏好设置。默认值为 any ，并使用可能返回 IPv4 或
chrome.sockets.tcpServer
Updated 2024年8月22日
借助 chrome.sockets.tcpServer API，您可以创建使用 TCP 连接的服务器应用。此 API 会取代之前在 chrome.socket API 中提供的 TCP 功能。 必须在 清单 中声明以下键才能使用此 API。 number 从底层网络调用返回的结果代码。 number 服务器套接字标识符。 number 客户端套接字标识符，即新建立的连接的套接字标识符。此套接字标识符只能与 chrome.sockets.tcp
chrome.app.window
Updated 2024年8月22日
使用 chrome.app.window API 创建窗口。Windows 有一个带有标题栏和大小控件的可选框架。而不会与任何 Chrome 浏览器窗口关联。如需查看这些选项的演示，请参阅 窗口状态示例 。 窗口 JavaScript“窗口”对象。 字符串 创建窗口时所用的 ID。 边界 窗口内容（不包括窗口装饰）的位置、大小和约束条件。这是 Chrome 36 中的新属性。 边界 窗口的位置、大小和约束条件，包括标题栏和框架等窗口装饰。这是 Chrome 36 中的新属性。 void
日志记录
Updated 2024年8月22日
默认情况下，ChromeDriver 只会将警告/错误记录到 stderr 中。调试时 启用更详细的日志记录会很有帮助。 若要启用详细日志记录功能，只需将 --verbose 传递给 chromedriver 服务器即可。 您也可以传递 --log-path ，使日志改为写入文件 错误。如果您没有直接自行启动 chromedriver 服务器， 需要通过 WebDriver 客户端库传递开关。有些客户端不 但很抱歉 将 --log-path 传递给 Chrome 启动命令时，Chrome
ChromeDriver 使用入门
Updated 2024年8月22日
本页记录了如何开始使用 ChromeDriver 来测试您的网站： 桌面 (Windows/Mac/Linux)。您还可以阅读 Android 使用入门 或 ChromeOS 使用入门 。 ChromeDriver 是 Selenium WebDriver 用于控制 Chrome 的独立可执行文件。此扩展程序由 Chromium 团队在 WebDriver 贡献者的帮助下进行维护。如果您不熟悉 Selenium WebDriver，则应访问 Selenium 网站 。
Chrome 扩展程序
Updated 2024年8月22日
您可以打包 Chrome 扩展程序，也可以将其解包。 要打包已解压的扩展程序，请使用 chrome://extensions 中的“打包”按钮，或 请使用 Chrome: "chrome.exe --pack-extension=C:\path\to\unpacked\extension --pack-extension-key=C:\myext.pem" 。如需解压缩打包的扩展程序，请按以下步骤操作： 提取文件。您可能需要将该文件的文件类型从.crx 重命名为.zip ， zip
chrome.browsingData
Updated 2024年8月22日
使用 chrome.browsingData API 从用户的本地个人资料中移除浏览数据。 您必须在 扩展程序清单 中声明 "browsingData" 权限，才能使用此 API。 此 API 最简单的用例是一种基于时间的机制，用于清除用户浏览数据。 您的代码应提供一个时间戳，指明历史日期，在此日期之后 浏览数据。此时间戳的格式设置为自事件发生以来经过的毫秒数 Unix 纪元（可以使用 getTime() 方法从 JavaScript Date 对象中检索）。
chrome.system.memory
Updated 2024年8月22日
chrome.system.memory API。 number 可用容量的量（以字节为单位）。 number 物理内存容量的总容量（以字节为单位）。 获取物理内存信息。 函数（可选） callback 参数如下所示： MemoryInfo Promise&lt; MemoryInfo &gt; 只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
chrome.dns
Updated 2024年8月21日
使用 chrome.dns API 进行 DNS 解析。 如需使用此 API，您必须在 清单 中声明 "dns" 权限。 以下代码会调用 resolve() 来检索 example.com 的 IP 地址。 service-worker.js ： 字符串（可选） 表示 IP 地址字面量的字符串。仅当 resultCode 指示成功时才提供。 number 结果代码。零表示成功。 解析给定的主机名或 IP 地址字面量。 字符串 要解析的主机名。 函数（可选） callback 参数如下所示：
Chrome 128 中的新功能
Updated 2024年8月20日
Chrome 128 现已推出！通过使用换行符改进红宝石元素的显示，Promise.try 来更轻松地启动 Promise 链，通过扩展 PointerEvent 接口来唯一地标识多种笔，等等。Adriana Jara 详细介绍了 Chrome 128 中面向开发者的新功能。
Chrome 128
Updated 2024年8月20日
Chrome 128 将于 2024 年 8 月 20 日开始逐步推出，包含 CSS ruby-align 属性 Promise.try 以及更多内容。
WebGPU 的新变化 (Chrome 128)
Updated 2024年8月20日
使用子群组进行实验，弃用线和点的深度偏差设置，隐藏未捕获的错误开发者工具警告（如果 preventDefault），先进行 WGSL 插值采样，然后执行上述任一操作。
File System Observer API 源试用
Updated 2024年8月20日
Chrome 团队正在对新的 File System Observer API 进行实验，该 API 可将文件系统发生的变化告知开发者。
提升了 Chromium 无障碍功能的性能
Updated 2024年8月20日
Ahmed Elwasefi 的一篇帖子，分享了他是如何通过 Google 夏季编程活动成为 Chromium 贡献者的。
chrome.alarms
Updated 2024年8月20日
使用 chrome.alarms API 安排代码定期运行或在未来的指定时间运行。 如需使用 chrome.alarms API，请在 清单 中声明 "alarms" 权限： 以下示例展示了如何使用和响应闹钟。如需试用此 API， 安装 chrome-extension-samples 中的 chrome-extension-samples 存储库 以下示例会在安装扩展程序时在 Service Worker 中设置警报： service-worker.js ： 以下示例根据已响铃闹钟的名称设置
chrome.contextMenus
Updated 2024年8月20日
使用 chrome.contextMenus API 向 Google Chrome 的上下文菜单中添加项。您可以选择从右键菜单中添加的对象类型，例如图片、超链接和页面。 上下文菜单项可以出现在任何文档（或文档中的框架）中，甚至是那些带有 file:// 的菜单项 或 chrome:// 网址。要控制您的内容可以显示在哪些文档中，请指定 documentUrlPatterns 字段。 create() update() 您可以根据需要创建任意数量的上下文菜单项，但如果扩展程序中的多个菜单项 则
chrome.audio
Updated 2024年8月20日
通过提供 chrome.audio API，用户可以获取有关系统连接到的音频设备的信息并控制该设备。此 API 目前只能在适用于 ChromeOS 的自助服务终端模式下使用。 字符串 设备名称。 DeviceType 设备类型。 字符串 简单易懂的名称（例如“USB 麦克风”）。 字符串 音频设备的唯一标识符。 布尔值 如果这是当前活跃设备，则为 true。 number 设备的音量、输出的音量、输入的增益。 字符串（可选） 稳定/持久保留的设备 ID 字符串（如果有）。 StreamType
chrome.commands
Updated 2024年8月20日
您可以使用 Command API 添加可在扩展程序中触发操作的键盘快捷键，例如，用于打开浏览器操作或向扩展程序发送命令的操作。 必须在 清单 中声明以下键才能使用此 API。 Commands API 允许扩展程序开发者定义特定命令，并将它们绑定到默认命令 组合键。扩展程序接受的每个命令都必须声明为 "commands" 对象。 属性键用作命令的名称。命令对象可以采用两个属性。 可选属性，用于声明命令的默认键盘快捷键。如果省略， 命令就会解除绑定此属性可以采用字符串或对象值。 字符串值
chrome.debugger
Updated 2024年8月20日
chrome.debugger API 可用作 Chrome 远程调试协议 的替代传输服务。使用 chrome.debugger 附加到一个或多个标签页，以便对网络交互进行插桩、调试 JavaScript、转变 DOM 和 CSS 等。使用 Debuggee 属性 tabId 可定位具有 sendCommand 的标签页，并通过 tabId 从 onEvent 回调对事件进行路由。 出于安全考虑， chrome.debugger API 不提供对所有 Chrome
chrome.declarativeContent
Updated 2024年8月20日
使用 chrome.declarativeContent API 可根据网页内容执行操作，而无需读取网页内容的权限。 声明式 Content API 可让您根据 或者 CSS 选择器与页面上的某个元素匹配，无需 添加 主机权限 或注入 内容脚本 。 使用 activeTab 权限，以在用户点击 操作。 规则由条件和操作组成。如果满足任一条件，则所有操作 。这些操作包括 setIcon 和 showAction 。 当且仅当所有网页都列出时， PageStateMatcher
chrome.declarativeNetRequest
Updated 2024年8月20日
chrome.declarativeNetRequest API 用于通过指定声明式规则来屏蔽或修改网络请求。这样一来，扩展程序就能够修改网络请求，而不会拦截这类请求并查看其中的内容，从而更好地保护用户隐私。 declarativeNetRequestFeedback host_permissions 除了上述权限之外，某些类型的规则集（具体来说是静态规则集）还要求声明 "declarative_net_request" 清单键，该清单键应该是具有一个名为 "rule_resources"
chrome.browsingData
Updated 2024年8月20日
使用 chrome.browsingData API 从用户的本地个人资料中移除浏览数据。 您必须声明“browsingData”权限，才能使用此 API。 此 API 最简单的用例是一种基于时间的机制，用于清除用户浏览数据。 您的代码应提供一个时间戳，指明历史日期，在此日期之后 浏览数据。此时间戳的格式设置为自事件发生以来经过的毫秒数 Unix 纪元（可通过 getTime 方法从 JavaScript Date 对象中检索）。 例如，要清除用户上周的所有浏览数据，您可以编写如下代码： 如下：
File System Access API：简化对本地文件的访问
Updated 2024年8月19日
借助 File System Access API，开发者可以构建功能强大的 Web 应用，与用户本地设备上的文件进行交互，例如 IDE、照片和视频编辑器、文本编辑器等。用户向 Web 应用授予访问权限后，此 API 可让用户直接读取或保存对用户设备上的文件和文件夹所做的更改。
WebDriver BiDi 可在 Firefox、Chrome 和 Puppeteer 中正式投入使用
Updated 2024年8月7日
Puppeteer 23 引入了对 Firefox 129 及更高版本的稳定支持，根据 WebDriver BiDi 为 Chrome 和 Firefox 自动化功能提供统一的 API。
Android 版 Chrome 中的通行密钥用户体验更新
Updated 2024年8月5日
Android 版 Chrome 现在集成了 Credential Manager，可让第三方密码管理工具在 Android 14 及更高版本上提供通行密钥
现在可在 BrowserStack 上通过 WebDriver BiDi 实现自动化
Updated 2024年8月1日
BrowserStack 引入 WebDriver BiDi 支持：通过事件驱动型自动化增强 Selenium 网格测试。
Chrome 127 中的新功能
Updated 2024年7月23日
Chrome 127 现已推出！借助对 font-size-adjust 的支持，Document Picture-in-Picture API 中传播的用户激活，以及键盘可聚焦滚动容器等众多功能。Adriana Jara 详细介绍了 Chrome 127 中面向开发者的新功能。
Chrome 如何帮助用户安装他们重视的应用
Updated 2024年7月23日
Chrome 的内部用户研究表明，许多用户都非常重视安装 Web 应用。这样做有诸多好处，例如： Chrome 和 Web 开发者可以通过多种方式提供帮助，包括新的机器学习促销功能。本文简要介绍了用户安装应用的方式。 符合 Chrome 的 可安装性条件 的应用会在 Chrome 桌面浏览器的地址栏中自动显示安装图标（在以下屏幕截图中突出显示）。用户可以点击以安装应用。 另一种安装方法是依次点按 更多 图标 保存和分享 安装 $appName 。
Chrome 127
Updated 2024年7月23日
Chrome 127 将于 2024 年 7 月 23 日开始发布，包含 CSS font-size-adjust、键盘可聚焦滚动容器，以及更多精彩内容。
WebGPU 的新变化 (Chrome 127)
Updated 2024年7月23日
针对 Android 上的 OpenGL ES、GPUAdapter 信息属性、WebAssembly 互操作性改进等方面的实验性支持。
Long Animation Frame API 现已发布
Updated 2024年6月24日
Long Animation Frame API (LoAF) 已经从 Chrome 123 开始提供，我们现在还更新了工具和指南，以帮助您充分利用以下新 API。
针对新 HTML <permission> 元素的源试用
Updated 2024年6月12日
Chrome 团队正在试验一种新的声明式 HTML <权限> 元素，该元素旨在请求用户获取对各种强大功能的使用权限。
WebGPU 的新变化 (Chrome 126)
Updated 2024年6月12日
提高了 maxTextureArrayLayers 限制、针对 Vulkan 后端优化了缓冲区上传、缩短了着色器编译时间、提交的命令缓冲区必须是唯一的，以及 Dawn 更新。
Chrome 126
Updated 2024年6月11日
Chrome 126 将于 2024 年 6 月 11 日推出，届时会进行跨文档视图转换、重新启用 CloseWatcher API，针对 Gamepad API 触发规则混乱，还有诸多其他功能。
Chrome 126 的新变化
Updated 2024年6月11日
Chrome 126 现已推出！凭借 ViewTransitions API 中对跨文档转换的支持，针对 Gamepad API 重新启用了 CloseWatcher API，触发器进行了混乱，还有许多其他功能以及更多其他功能。Adriana Jara 介绍了 Chrome 126 为开发者提供的所有详细信息。
跳过审核以查找符合条件的附加信息更改
Updated 2024年5月30日
我们很高兴地宣布推出一项新功能，该功能可让开发者使用声明式 Net Request API 跳过对 Manifest V3 扩展程序符合条件的更改的审核流程。
2024 年 I/O 大会 Web AI 总结：为您的下一个 Web 应用打造的新模型、工具和 API
Updated 2024年5月16日
阅读 2024 年 I/O 大会上的 Web AI 总结。了解适用于您的下一个 Web 应用的新模型、工具和 API。
Chrome 126 Beta 版
Updated 2024年5月16日
Chrome 126 Beta 版包含跨文档视图转换，以及 Gamepad API Trigger-Rumble 扩展程序和其他功能。
有助于加快 Web AI 速度的 WebAssembly 和 WebGPU 增强功能（第 2 部分）
Updated 2024年5月16日
第 2 部分（共 2 部分）。了解 WebAssembly 和 WebGPU 增强功能如何提高 Web 上的机器学习性能。
用于实现更快的 Web AI 的 WebAssembly 和 WebGPU 增强功能（第 1 部分）
Updated 2024年5月16日
第 1 部分（共 2 部分）。了解 WebAssembly 和 WebGPU 增强功能如何提升 Web 上的机器学习性能。
视图转换有哪些新变化？（2024 年 Google I/O 大会更新）
Updated 2024年5月16日
宣布推出适用于 MPA 的跨文档视图转换、使用活动类型的选择性视图转换，以及使用 view-transition-class 共享动画样式。
Chrome 125
Updated 2024年5月14日
Chrome 125 将于 2024 年 5 月 14 日开始发布，其中包含 CSS Anchor 定位、Compute Pressure API 和新的 Baseline 功能，以及更多其他功能。
2024 年 Google I/O 大会的 10 项更新：为每位 Web 开发者解锁 AI 的强大功能
Updated 2024年5月14日
通过 Google I/O 开发者主旨演讲和讲座探索精彩功能。
Chrome 125 的新变化
Updated 2024年5月14日
Chrome 125 现已推出！利用 CSS Anchor Positioning API、Compute Pressure API、Storage Access API 扩展等等。Adriana Jara 介绍了 Chrome 125 为开发者提供的所有详细信息。
Spotify 如何使用 Picture-in-Picture API 构建 Spotify Miniplayer
Updated 2024年5月13日
了解 Spotify 迷你播放器如何从“画布摄影”转变为通过 Document Picture-in-Picture API 实现的精致体验。
使用 Chrome 中的工具进行顺畅的自动化测试
Updated 2024年5月9日
简要介绍 Puppeteer、Chrome Headless 和 Chrome for Testing，以及 Chrome 工具团队提供的其他资源。
为什么 CSS 和界面功能对您的电子商务网站很重要？
Updated 2024年5月7日
了解电子商务网站如何从实现最新的 CSS 和界面功能（视图转换、滚动驱动的动画、Popover API 等）中受益。
针对非安全上下文的专用网络访问 (PNA) 弃用试用已结束 - 请实施 PNA 权限提示
Updated 2024年4月24日
如果要从无法转换成 HTTPS 的网站访问专用网络设备，您必须使用权限提示来放宽混合内容检查要求。
不注册用于控制 page 和 start_url 的 Service Worker
Updated 2024年4月16日
了解如何注册支持渐进式 Web 应用功能（例如离线功能、推送通知和可安装性）的 Service Worker。
Chrome 124
Updated 2024年4月16日
Chrome 124 将于 2024 年 4 月 16 日开始发布，其中包括 setHTMLUnsafe、WebSocket 流以及更多其他功能。
Chrome 124 的新变化
Updated 2024年4月16日
Chrome 124 现已推出！有两个新 API 支持从 JavaScript 使用声明性 shadow DOM。您可以在 Web Socket 中使用流。改进了视图过渡。还有很多其他功能。Pete LePage 介绍了 Chrome 124 中面向开发者的新功能的所有详细信息。
如何通过 PageSpeed Insights 查看 Chrome 用户体验报告数据
Updated 2024年4月9日
PageSpeed Insights (PSI) 是一款供 Web 开发者了解网页性能指标及改进方法的工具。在本指南中，您将了解如何使用 PSI 从 CrUX 中提取数据洞见，并更好地了解用户体验。