action.getPopup()

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

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

这是一个异步函数，它返回一个 Promise。

语法

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

参数

details

具有以下属性的对象

tabId 可选

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

windowId 可选

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

  • 如果同时提供 windowId 和 tabId，则该函数将失败。
  • 如果同时省略 windowId 和 tabId，则将返回全局弹出窗口。

返回值

一个 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);

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

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