pageAction.show()

在指定的标签页中显示页面操作。只要指定的标签页是活动标签页就会显示页面操作。

show() 会覆盖模式匹配,所以即使 show_matches 不匹配 URL 或者 hide_matches 匹配 URL,页面操作也会在指定的标签页中显示。

请注意,对没有加载内容的标签页调用 show() 将不起作用。

语法

js
browser.pageAction.show(
  tabId // 整型
)

参数

tabId

integer。要显示页面操作的标签页的 ID。

返回值

Promise,将以 undefined 兑现。

浏览器兼容性

BCD tables only load in the browser

示例

该示例在用户选择一个上下文菜单项时将在活动标签页中显示页面操作

备注: 你需要在你的清单中取得 contextMenus 权限来创建上下文菜单项。

js
browser.contextMenus.create({
  id: "show",
  title: "显示页面操作",
});

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

示例扩展

备注: 该 API 基于 Chromium 的 chrome.pageAction API。本文衍生自 Chromium 代码中的 page_action.json