pageAction.show()

显示给定 pageActiontab。当给定的 tab 是活动 tab 时,page action 就会显示。

show() 会覆盖模式匹配,因此即使 show_matches 没有匹配 URL 或 hide_matches 匹配了 URL,page action 也会在指定的 tab 中显示。

请注意,对没有加载内容的 tab 调用 show() 没有效果。

语法

js
browser.pageAction.show(
  tabId // integer
)

参数

tabId

integer。您希望显示 page action 的 tab 的 ID。

返回值

一个 Promise,它将以 undefined fulfilled。

示例

此示例显示当用户选择一个上下文菜单项时,活动 tab 的 pageAction

注意:您需要在您的 manifest 中包含 contextMenus permission 才能创建上下文菜单项。

js
browser.contextMenus.create({
  id: "show",
  title: "Show page action",
});

browser.contextMenus.onClicked.addListener((info, tab) => {
  if (info.menuItemId === "show") {
    browser.pageAction.show(tab.id);
  }
});

扩展程序示例

浏览器兼容性

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