概述

显示

“浏览器操作”：{//必需“default_icon”：{…}，//与“图标”格式相同“default_popup”：“页面URL”，//可选“default_title”：“标题字符串”//必需}

上下文

此API在窗口上下文（背景、事件、弹出窗口、选项和自定义页面）中可用。

WebIDL定义

特殊情况说明WebIDL语法注意事项对于浏览器扩展，在本文档的其他地方进行了定义。

字典浏览器外部浏览器操作默认值{浏览器ExtIconArray？defaultIcon；DOMString？默认弹出菜单；DOMString？默认标题；};部分字典BrowserExtManifest{浏览器外部浏览器操作默认值？浏览器操作默认值；};typedef序列<byte>BrowserExtColorArray；字典浏览器ExtTabIdDetails{长选项卡Id；};字典浏览器ExtBadgeColorArrayTabId{浏览器ExtColorArray颜色；长选项卡Id；};字典浏览器ExtBadgePathTabId{DOMString路径；长选项卡Id；};字典浏览器ExtBadgeTextTabId{长选项卡Id；DOMString文本；};字典浏览器ExtBadgeTabIdPopup{DOMString弹出HTMLFileName；长选项卡Id；};回调BrowserExtBrowserActionOnClickedCallback=void（BrowserExtTabsTab选项卡）；[无接口对象]接口浏览器外部浏览器操作{无效禁用（长tabId）；void enable（长tabId）；承诺<BrowserExtColorArray>getBadgeBackgroundColor（BrowserExtTabIdDetails详细信息）；承诺<DOMString？>getBadgeText（浏览器ExtTabIdDetails详细信息）；承诺<DOMString？>getPopup（浏览器ExtTabIdDetails详细信息）；BrowserExtEvent onClicked（BrowserExtBrowserActionOnClickedCallback回调）；void setBadgeBackgroundColor（浏览器ExtBadgeColorArrayTabId详细信息）；void setBadgeText（浏览器ExtBadgeTextTabId详细信息）；Promise＜void＞setIcon（BrowserExtBadgePathTabId详细信息）；void setPopup（浏览器ExtBadgeTabIdPopup详细信息）；};[NoInterfaceObject，Exposed=窗口，CheckAnyPermissions_browserExtBrowserAction_]接口BrowserExtBrowserActionAPI{只读属性BrowserExtBrowserAction浏览器操作；};浏览器实现BrowserExtBrowserActionAPI；

概述

这个上下文菜单对象允许将其他条目添加到浏览器的上下文菜单中。菜单将选择性地显示各种浏览器UI元素（浏览器操作或页面操作按钮）或页面元素（框架、图像、链接、页面、选择等）。

清单

A类“上下文菜单”条目必须在“权限”键。图标键是可选的。

“权限”：[//必需“contextMenus”//必需]，//必需“图标”：{//可选“<size>”：“<name.png>”//可选，建议16号}//可选

上下文

此API在窗口上下文（背景、事件、弹出窗口、选项和自定义页面）中可用。

WebIDL定义

特殊情况说明WebIDL语法注意事项对于浏览器扩展，在本文档的其他地方进行了定义。

enum BrowserExtContextType{“all”，“audio”，“browser_action”，“editable”，“frame”，“image”，“link”，”page“，”page_action“，“selection”，“video”}；enum BrowserExtItemType{“checkbox”，“normal”，“radio”，“separator”}；字典浏览器ExtContextMenuCreateDetails{布尔校验；序列<上下文类型>？语境；序列<DOMString>？documentUrlPatterns；启用布尔值；DOMString？身份证件；功能onclick；（long还是DOMString？）parentId；序列<DOMString>？targetUrlPatterns；DOMString？标题；DOM字符串？类型；};字典浏览器ExtContextMenuUpdateDetails{布尔校验；序列<BrowserExtContextType>？语境；序列<DOMString>？documentUrlPatterns；启用布尔值；功能onclick；长parentId；序列<DOMString>？targetUrlPatterns；DOMString？标题；ItemType？类型；};字典浏览器ExtContextMenuOnClickedDetails{布尔校验；布尔可编辑；长帧Id；DOMString？框架URL；DOMString？链接URL；DOMString？媒体类型；（long或DOMString）menuItemId；DOMString？页面URL；（long还是DOMString？）parentMenuItemId；DOMString？selectionText；DOMString？srcUrl；布尔值被选中；};回调BrowserExtContextMenuOnClickedCallback=void（BrowserextContextMenu OnClicked详细信息，BrowserExtTabsTab选项卡）；[无接口对象]界面BrowserExtContextMenus{Promise<long>create（BrowserExtContextMenuCreateDetails详细信息）；BrowserExtEvent onClicked（BrowserExtContextMenuOnClickedCallback回调）；Promise<void>remove（（long或DOMString）itemId）；承诺<void>removeAll（）；Promise<void>update（（long或DOMString）itemId，BrowserExtContextMenuUpdateDetails详细信息）；};[NoInterfaceObject，Exposed=窗口，CheckAnyPermissions_browserExtContextMenus_]界面BrowserExtContextMenusAPI{只读属性BrowserExtContextMenus contextMenus；};Browser实现BrowserExtContextMenusAPI；

概述

这个i81亿对象提供了一种访问已本地化为支持语言的字符串的方法。

显示

提供本地化字符串时，必须使用两个字符的代码指定默认区域设置。代码可在RFC1766协议或IETF BCP47接口。本地化清单字符串时，使用以下语法。

“default_locale”：“<twoCharLocaleCode>”，//必需“name”：“__MSG_<yourCustomNameStringIdentifier>__”，“description”：“__MSG_<yourCustomDescriptionStringIdentifier>__”，

“default_locale”：“en”，//英文“name”：“__MSG_MySampleExtension__”，“description”：“__MSG_MySampleExensionDescription__”，

本地化字符串

每个支持的区域设置都必须有自己的messages.json消息存储在文件夹中的文件_区域设置/＜twoCharLocaleCode＞。此处用于目录名的双字符代码与mainfest.json公司以指定默认_位置.

区域设置代码和匹配

与通用标准相反，API返回的文件/目录名称中使用的区域设置代码的格式如下：

也就是说，一个两个字母的语言代码，可以选择后跟一个下划线和一个两字母的区域代码。匹配区域设置代码，以便使用精确匹配（如果可用），返回到最不特定、最接近的匹配。因此，对于“en_US”，将按优先顺序选择以下区域设置：

• en_US（_US）
• 环境_US_var
• 英语
• en_GB（_G）
• 环境GB_var

字符串标记

字符串通过预处理消息本地化，替换|$[a-zA-Z0-9型@_]+$|代币及其替代品的价值。稍后，它将处理的结果字符串|$[0-9]美元|替换。

允许使用任意数量的连续|$|，并替换为该数字减去1。的实例|$|后面跟任意数量的连续数字也是允许的，但提供9个以上替换的本地化字符串将被忽略。

区域设置消息替换

表单中的区域设置消息__消息_<消息名称>_将自动替换为CSS文件中相应的本地化消息和某些manifest.json字符串值。具体来说，替换是根据正则表达式进行的__味精_([A-Za-z0-9@_]+?)__，这意味着第一次出现__将立即终止消息名。

CSS文件作为原始文本流进行预处理，不考虑CSS语法。宣言.json值在JSON解析后进行处理，结果始终被视为文字字符串。将为本地化消息处理以下清单键：

• 名称
• 短名称
• 描述
• 作者
• 主页url
• 开发人员姓名
• 开发人员.url
• 浏览器操作默认标题
• 浏览器操作默认url
• 页面动作默认标题
• 页面操作默认url

占位符

翻译后的字符串可能包含不会被翻译或将被变量内容替换的子字符串。例如

“消息示例”：{“消息”：“您单击了$URL$。”，“description”：“告诉用户他们单击了哪个链接。”，“占位符”：{“url”：{“内容”：“$1”“示例”：“https://www.w3.org"}

占位符名称（上例中的“url”）用于表示替换字符串中的占位符（例如，“url“变为$url$）。它不区分大小写，可以包含与消息字符串名称相同的字符。

这个“内容”项定义占位符的内容。这可以是硬编码字符串，例如“My placeholder”，但也可以包括从i18n.getMessage（）调用中获得的值。

可选的“示例”项目旨在通过向翻译人员展示占位符在最终用户中的显示方式来帮助翻译人员，使他们能够在本地化文件时做出最佳选择。

上下文

此API在窗口上下文（背景、事件、弹出窗口、选项和自定义页面）和内容脚本上下文中可用。

WebIDL定义

特殊情况说明WebIDL语法注意事项对于浏览器扩展，在本文档的其他地方进行了定义。

[无接口对象]接口浏览器ExtI18n{DOMString getMessage（DOMString-messageName，sequence<DOMStrig？>？substitutions）；};[NoInterfaceObject，Exposed=（Window，ContentScript），CheckAnyPermissions_browserExt_]界面浏览器ExtI18nAPI{只读属性BrowserExtI18n i18n；};浏览器实现BrowserExtI18nAPI；部分字典BrowserExtManifest{DOM字符串？defaultLocaleValue；};

概述

这个页面操作对象将按钮添加到浏览器应用程序中，通常位于地址栏中。此按钮通常仅在扩展检测到它可以在活动选项卡的当前页面上执行操作时显示浏览器操作不能有页面操作和vice-versa。

显示

这个“页面操作”和“默认标题”需要密钥。其他键是可选的。

“page_action”：{//必需“default_icon”：{…}，//与“图标”格式相同“default_popup”：“页面URL”，//可选“default_title”：“标题字符串”//必需}

上下文

此API在窗口上下文（背景、事件、弹出窗口、选项和自定义页面）中可用。

WebIDL定义

特殊情况说明WebIDL语法注意事项对于浏览器扩展，在本文档的其他地方进行了定义。

字典浏览器ExtPageActionDefaults{浏览器ExtIconArray？默认图标；DOMString？默认弹出菜单；DOMString？默认标题；};部分字典BrowserExtManifest{浏览器ExtPageActionDefaults？pageActionDefaults；};字典浏览器ExtBadgePath{DOMString路径；};回调BrowserExtPageActionOnClickedCallback=void（BrowserExtTabsTab选项卡）；界面BrowserExtPageAction{承诺<DOMString？>getPopup（浏览器ExtTabIdDetails详细信息）；承诺<DOMString？>getTitle（BrowserExtTabIdDetails详细信息）；void hide（长tabId）；BrowserExtEvent onClicked（BrowserExtPageActionOnClickedCallback回调）；Promise<void>setIcon（BrowserExtBadgePath路径）；void setPopup（浏览器ExtBadgePathTabId详细信息）；void setTitle（BrowserExtBadgeTextTabId详细信息）；空显示（长tabId）；};[NoInterfaceObject，Exposed=窗口，CheckAnyPermissions_browserExtPageAction_]接口BrowserExtPageActionAPI{只读属性BrowserExtPageAction pageAction；};浏览器实现BrowserExtPageActionAPI；

概述

这个运行时对象用于跨上下文发送和接收消息，以及访问扩展级信息，如id、清单和资源的绝对路径。

显示

扩展使用此对象不需要其他清单条目。但是，如果声明了“externally_connectable”键，则扩展将仅接收来自托管网页的消息。此外，扩展将通过仅指定批准的扩展来阻止来自其他扩展的消息。请注意，如果此键用于允许网页发送消息，除非“id”：[“*”]则来自其他扩展的所有消息都将被阻止。中的URL“匹配项”数组必须包含一个顶级域。此列表不影响内容脚本。

“外部可连接”：[“ids”：[…]，//允许发送消息的其他扩展的标识符“匹配”：[…]//允许发送消息的托管网页的URL模式]

上下文

此API在窗口上下文（背景、事件、弹出窗口、选项和自定义页面）、内容脚本上下文和Internet宿主网页上下文中可用。

WebIDL定义

特殊情况说明WebIDL语法注意事项对于浏览器扩展，在本文档的其他地方进行了定义。

enum BrowserExtRuntimeOnInstalledReason{“浏览器更新”，“扩展安装”，“延伸更新”}；字典浏览器ExtRuntimeOnInstalledDetails{BrowserExtRuntimeOnInstalledReason原因；DOMString？上一版本；DOMString？身份证件；};字典浏览器ExtRuntimePort{功能断开；DOMString名称；对象onDisconnect；消息对象；函数postMessage；浏览器ExtRuntimeMessageSender？发件人；};字典浏览器ExtRuntimeMessageSender{DOMString？身份证件；长帧Id；浏览器ExtTabsTab？选项卡；DOMString？网址；};回调BrowserExtRuntimeOnConnectCallback=void（BrowserExtRuntimePort端口）；callback BrowserExtRuntimeOnInstalledCallback=void（BrowserExtRuntimeOnInstalledDetails详细信息）；callback BrowserExtRuntimeOnMessageCallback=void（可选任意消息，BrowserExtRuntimeMessageSender发送方，Browser ExtRuntimeSendResponseCallback回调）；[无接口对象]界面BrowserExtBrowserRuntime{对象getManifest（）；DOMString getURL（DOMString-path）；属性DOMString id；void onConnect（BrowserExtRuntimeOnConnectCallback回调）；void onInstalled（BrowserExtRuntimeOnInstalledCallback回调）；void onMessage（BrowserExtRuntimeOnMessageCallback回调）；Promise<any>sendMessage（可选DOMString extensionId，任意消息）；属性BrowserExtRuntimePort端口；属性BrowserExtRuntimeMessageSender MessageSender；};[NoInterfaceObject，Exposed=窗口，CheckAnyPermissions_browserExt_]接口BrowserExtRuntimeAPI{只读属性BrowserExtRuntime运行时；};浏览器实现BrowserExtRuntimeAPI；

概述

这个选项卡对象用于访问有关选项卡的元数据，如其标题，或访问选项卡本身中的当前内容。

显示

这个“选项卡”使用此对象需要权限。请参阅活动选项卡许可部分获取有关访问这些API的更多信息。

{“权限”：[//必需“tabs”//需要“tab”或“activeTab”“activeTab”//需要“tabs”或“activeLab”]//必需}

上下文

此API在窗口上下文（背景、事件、弹出窗口、选项和自定义页面）中可用。

WebIDL定义

特殊情况说明WebIDL语法注意事项对于浏览器扩展，在本文档的其他地方进行了定义。

enum BrowserExtTabMutedReasonDetails{“用户”，“捕获”，“扩展”}；enum BrowserExtRunAt{“document_end”，“document _ idle”，“document_start”}；enum BrowserExtTabStatus{“完成”，“加载”}；enum BrowserExtWindowTypes{“应用”，“正常”，“面板”，“弹出”}；enum BrowserExtTabsCaptureVisibleTabFormat{“jpeg”，“png”}；字典浏览器ExtTabsTab{布尔活动；布尔可听；DOMString？收藏夹URL；布尔突出显示；长高；长id；布尔隐姓埋名；长指数；选项卡静音细节？mutedDetails；长openerTabId；布尔钉住；DOMString？会话ID；DOMString？地位；DOMString？标题；DOMString？网址；长宽度；长窗口ID；};字典浏览器ExtTabMutedDetails{DOMString？扩展ID；布尔静音；选项卡静音原因详细信息？原因；};字典浏览器ExtTabConnectDetails{长帧Id；DOMString？名称；};字典浏览器ExtTabCreateDetails{布尔活动；长指数；长openerTabId；布尔钉住；DOMString？网址；长窗口ID；};字典浏览器外部选项卡脚本和CSS详细信息{布尔型allFrames；DOMString？代码；DOMString？文件；长帧Id；布尔匹配AboutBlank；浏览器ExtRunAt？运行于；};字典浏览器ExtTabsCaptureVisibleTabDetails{浏览器ExtTabsCaptureVisibleTabFormat图像捕获格式；长jpegQuality；};字典浏览器ExtTabQueryDetails{布尔活动；布尔可听；布尔currentWindow；布尔突出显示；长指数；布尔lastFocusedWindow；布尔静音；布尔钉住；选项卡状态？地位；DOMString？标题；（DOMString？或序列<DOMString>？）url；长窗口ID；窗口类型？windowType；};字典浏览器ExtTabReloadDetails{布尔旁路缓存；};字典浏览器ExtTabSendMessageDetails{长帧Id；};字典浏览器ExtTabUpdateDetails{布尔活动；布尔突出显示；布尔静音；长openerTabId；布尔固定；DOMString？网址；};字典浏览器ExtTabIdWindowId{长选项卡Id；长窗口ID；};字典浏览器ExtTabsWindowsIdIsWindowClosing{布尔值为WindowClosing；长窗口ID；};字典浏览器ExtTabsOnUpdatedChangeDetails{布尔可听；DOM字符串？favIconUrl；选项卡静音细节？mutedDetails；布尔钉住；DOMString？地位；DOM字符串？标题；DOMString？网址；};回调BrowserExtTabsOnActivatedCallback=void（BrowserextTabIdWindowsId activeDetails）；回调BrowserExtTabsOnCreatedCallback=void（浏览器ExtTabTab选项卡）；回调BrowserExtTabsOnRemovedCallback=void（长tabId，BrowserextTabsWindowsIdIsWindowClosing removeDetails）；回调BrowserExtTabsOnUpdatedCallback=void（长选项卡Id，BrowserextTabsOnUpdate更改详细信息，Browser ExtTabsTab选项卡）；[无接口对象]界面BrowserExtBrowserTabs{Promise<DOMString>captureVisibleTab（长窗口ID，BrowserExtTabsCaptureVissibleTabDetails详细信息）；RuntimePort连接（long tabId，BrowserExtTabConnectDetails详细信息）；Promise<BrowserExtTabsTab>create（BrowserExtTabCreateDetails详细信息）；void executeScript（长tabId、BrowserExtTabScript和CSSDetails详细信息）；承诺<BrowserExtTabsTab>get（long tabId）；承诺<BrowserExtTabsTab>getCurrent（）；void insertCSS（长tabId、BrowserExtTabScript和CSSDetails详细信息）；void onActivated（BrowserExtTabsOnActivatedCallback回调）；void onCreated（BrowserExtTabsOnCreatedCallback回调）；void onRemoved（BrowserExtTabsOnRemovedCallback回调）；void onUpdated（BrowserExtTabsUnUpdatedCallback回调）；Promise查询（BrowserExtTabQueryDetails queryDetails）；承诺重新加载（BrowserExtTabReloadDetails详细信息）；Promise<void>删除（（long或sequence<long>）tabIds）；Promise<any>sendMessage（长tabId，任意消息，可选BrowserExtTabSendMessageOptions详细信息）；Promise<BrowserExtTabsTab>update（可选长tabId，BrowserExtTabUpdateDetails详细信息）；};[NoInterfaceObject，Exposed=窗口，CheckAnyPermissions_browserExtTabs_]界面浏览器ExtTabsAPI{只读属性BrowserExtTabs选项卡；};浏览器实现BrowserExtTabsAPI；

概述

这个Web导航对象用于监视与网络请求相关的事件。

显示

这个“网络导航”使用此对象需要权限。

{“权限”：[//必需“webNavigation”//必需]//必需}

上下文

此API在窗口上下文（背景、事件、弹出窗口、选项和自定义页面）中可用。

WebIDL定义

特殊情况说明WebIDL语法注意事项对于浏览器扩展，在本文档的其他地方进行了定义。

enum BrowserExtTransitionType{“链接”，“类型化”}；字典浏览器外部Web导航打开前导航详细信息{长帧Id；长parentFrameId；长选项卡Id；双时间戳；DOMString url；};字典浏览器ExtWebNavigationOnCommittedDetails{长帧Id；长进程ID；长选项卡Id；双时间戳；转换类型转换类型；DOMString url；};字典浏览器ExtWebNavigationOnCompletedDetails{长帧Id；长进程ID；长选项卡Id；双时间戳；DOMString url；};字典浏览器ExtWebNavigationOnDOMContentLoadedDetails{长帧Id；长进程ID；长标签ID；双时间戳；DOMString url；};字典浏览器ExtWebNavigationOnErrorOccurredDetails{DOMString错误；长帧Id；长标签ID；双时间戳；DOMString url；};字典浏览器ExtWebNavigationOnReferenceFragmentUpdatedDetails{长帧Id；长进程ID；长选项卡Id；双时间戳；浏览器ExtTransitionType转换类型；DOMString url；};回调BrowserExtWebNavigationOnBeforeNavigateCallback=void（BrowserextWebNavigation OnBefore NavigateDetails详细信息）；callback BrowserExtWebNavigationOnCommittedCallback=void（BrowserExtWebNavigationOnCommittedDetails详细信息）；回调BrowserExtWebNavigationOnCompletedCallback=void（BrowserextWebNavigtionOnCompleted详细信息）；回调BrowserExtWebNavigationOnDOMContentLoadedCallback=void（BrowserextWebNavigtionOnDOMCentLoaded详细信息）；回调BrowserExtWebNavigationOnErrorOccurredCallback=void（BrowserextWebNavigtionOnErrorocurredDetails详细信息）；回调BrowserExtWebNavigationOnReferenceFragmentUpdated=void（BrowserextWebNavigation OnReference FragmentUpdate详细信息）；[无接口对象]界面BrowserExtBrowserWebNavigation{void onBeforeNavigate（浏览器ExtWebNavigationOnBeforeNavigateCallback回调）；void onCommitted（BrowserExtWebNavigationOnCommittedCallback回调）；void onCompleted（BrowserExtWebNavigationOnCompletedCallback回调）；void onDOMContentLoaded（BrowserExtWebNavigationOnDOMContent LoadedCallback回调）；void onErrorOccurred（BrowserExtWebNavigationOnErrorOcurredCallback回调）；void onReferenceFragmentUpdated（BrowserExtWebNavigationOnReferenceFagmentUplated回调）；};[NoInterfaceObject，Exposed=窗口，CheckAnyPermissions_browserExtWebNavigation_]界面BrowserExtWebNavigationAPI{只读属性BrowserExtWebNavigation webNavigation；};浏览器实现BrowserExtWebNavigationAPI；

概述

这个Web请求对象用于修改或取消网络请求。

显示

这个“网络请求”使用此对象需要权限。

{“权限”：[//必需“webRequest”//必需“webRequestBlocking”//可选“<URL pattern>”//可选，例如“*：//*.w3.org/”]//必需}

上下文

此API在窗口上下文（背景、事件、弹出窗口、选项和自定义页面）中可用。

WebIDL定义

特殊情况说明WebIDL语法注意事项对于浏览器扩展，在本文档的其他地方进行了定义。

enum BrowserExtResourceType{“font”，“image”，“main_frame”，“object”，“other”，”ping“，”script“，”stylesheet“，”sub_frame“，”xmlhttprequest“}；字典浏览器ExtWebRequestUploadDetails{任何字节；DOMString？文件；};字典浏览器ExtWebRequestRequestBody{DOMString？误差；对象？表单数据；序列<BrowserExtWebRequestUploadData>？原始数据；};字典浏览器ExtWebRequestHttpHeader{DOMString keyName；任何值；};字典浏览器ExtWebRequestHttpHeaders{序列<BrowserExtWebRequestHttpHeader>data；};字典浏览器ExtWebRequestOnBeforeRequestDetails{长帧Id；DOMString方法；长parentFrameId；浏览器ExtWebRequestRequestBody？请求正文；DOMString请求ID；长选项卡Id；双时间戳；BrowserExtResourceType类型；DOMString url；};字典浏览器ExtWebRequestOnBeforeSendHeaders详细信息{长帧Id；DOMString方法；长parentFrameId；浏览器ExtWebRequestHttpHeaders？requestHeaders；DOMString请求ID；长标签ID；双时间戳；BrowserExtResourceType类型；DOMString url；};字典浏览器ExtWebRequestOnCompletedDetails{长帧Id；布尔fromCache；DOMString方法；长parentFrameId；DOMString请求ID；浏览器ExtWebRequestHttpHeaders？responseHeaders；DOMString？服务器IP；长状态代码；DOMString statusLine；长选项卡Id；双时间戳；BrowserExtResourceType类型；DOMString url；}；字典浏览器ExtWebRequestOnHeadersReceivedDetails{长帧Id；DOMString方法；长parentFrameId；DOMString请求ID；浏览器ExtWebRequestHttpHeaders？responseHeaders；长状态代码；DOMString statusLine；长选项卡Id；双重时间戳；BrowserExtResourceType类型；DOMString url；};字典浏览器ExtWebRequestOnSendHeadersDetails{长帧Id；DOMString方法；长parentFrameId；浏览器ExtWebRequestHttpHeaders？requestHeaders；DOMString请求ID；长选项卡Id；双时间戳；BrowserExtResourceType类型；DOMString url；};回调BrowserExtWebRequestOnBeforeRequestCallback=void（BrowserextWebRequestonBefore请求详细信息）；回调BrowserExtWebRequestOnBeforeSendHeadersCallback=void（BrowserextWebRequestonBeforesendHeaders详细信息）；回调BrowserExtWebRequestOnCompletedCallback=void（BrowserExtWebRequestOnCompletedDetails详细信息）；回调BrowserExtWebRequestOnHeadersReceivedCallback=void（BrowserExtWebRequestOnHeadersReceivedDetails详细信息）；callback BrowserExtWebRequestOnSendHeadersCallback=void（浏览器ExtWebRequest OnSendheadersDetails详细信息）；[无接口对象]接口BrowserExtBrowserWebRequest{void onBeforeRequest（BrowserExtWebRequestOnBefore请求回调）；void onBeforeSendHeaders（BrowserExtWebRequestOnBeforeSendHeadersCallback回调）；void onCompleted（BrowserExtWebRequestOnCompletedCallback回调）；void onHeadersReceived（BrowserExtWebRequestOnHeadersReceivedCallback回调）；void onSendHeaders（函数回调）；};[NoInterfaceObject，Exposed=窗口，CheckAnyPermissions_browserExtWebRequest_]接口浏览器ExtWebRequestAPI{只读属性BrowserExtWebRequest webRequest；};浏览器实现BrowserWebRequestAPI；

概述

这个窗户对象用于访问由浏览器管理的UI窗口。

显示

扩展使用此对象不需要其他清单条目。

上下文

此API在窗口上下文（背景、事件、弹出窗口、选项和自定义页面）中可用。

WebIDL定义

特殊情况说明WebIDL语法注意事项对于浏览器扩展，在本文档的其他地方进行了定义。

enum BrowserExtWindowsWindowType{“detached_panel”，“normal”，“panel”，”popup“}；enum BrowserExtWindowsWindowState{“停靠”，“全屏”，“最大化”，“最小化”，“正常”}；字典浏览器ExtCreateWindowDetails{布尔聚焦；长高；布尔隐姓埋名；长左；浏览器ExtWindowsWindowsState？国家；长选项卡Id；长顶；（DOMString？或序列<DOMString>？）url；长宽；浏览器扩展窗口窗口类型？windowType；};字典浏览器ExtGetWindowDetails{布尔填充；序列<BrowserExtWindowsWindowType>？窗口类型；};字典浏览器ExtWindowUpdateDetails{布尔drawAttention；布尔聚焦；长高；左长；长顶；长宽；浏览器ExtWindowState？窗口状态；};字典浏览器ExtWindowsWindow{布尔值始终位于顶部；布尔聚焦；长高；长id；布尔隐姓埋名；左长；序列<BrowserExtTabsTab>？选项卡；长顶；DOMString？sessionId；浏览器ExtWindowsWindowsState？国家；长宽；浏览器扩展窗口窗口类型？windowType；};回调BrowserExtWindowsOnFocusChangedCallback=void（长windowId）；[无接口对象]界面BrowserExtWindows{承诺<BrowserExtWindowsWindow>create（CreateWindowDetails详细信息）；Promise<BrowserExtWindowsWindow>get（long windowId，可选BrowserExtGetWindowDetails详细信息）；Promise<sequence<BrowserExtWindowsWindow>>getAll（可选的BrowserExtGetWindowDetail详细信息）；Promise<BrowserExtWindowsWindow>getCurrent（可选的BrowserExtGetWindowDetail详细信息）；Promise<BrowserExtWindowsWindow>getLastFocused（可选的BrowserExtGetWindowDetail详细信息）；void onFocusChanged（BrowserExtWindowsOnFocusChangerdCallback回调）；承诺<BrowserExtWindowsWindow>update（长windowId，可选BrowserextWindowsUpdateDetails详细信息）；};[NoInterfaceObject，Exposed=窗口，CheckAnyPermissions_browserExt_]界面浏览器ExtWindowsAPI{只读属性BrowserExtWindows窗口；};浏览器实现BrowserExtWindowsAPI；