action.getPopup()

获取为此浏览器操作设置的弹出窗口的 HTML 文档。

注意:此 API 在 Manifest V3 或更高版本中可用。

这是一个异步函数,返回一个 Promise

语法

js
let gettingPopup = browser.action.getPopup(
  details               // object
)

参数

details

具有以下属性的对象:

tabId 可选

integer。要获取其弹出窗口的选项卡。

windowId 可选

integer。要获取其弹出窗口的窗口。

  • 如果同时提供了 windowIdtabId,则函数将失败。
  • 如果同时省略了 windowIdtabId,则会返回全局弹出窗口。

返回值

一个 Promise,它将以包含弹出窗口文档 URL 的字符串进行兑现。这将是一个完全限定的 URL,例如 moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/popups/popup2.html

示例

获取弹出窗口的 URL

js
function gotPopup(popupURL) {
  console.log(popupURL);
}

let gettingPopup = browser.action.getPopup({});
gettingPopup.then(gotPopup);

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.action API。此文档源自 Chromium 代码中的 browser_action.json