browserAction.setTitle()

語法

browser.browserAction.setTitle(
  details // object
)

引數

details

object。新的標題，以及可選的要定位的標籤頁或視窗的 ID。

title

string 或 null。當滑鼠懸停在瀏覽器操作圖示上時，瀏覽器操作應顯示的字串。

如果 title 為空字串，則使用的標題將是副檔名，但 browserAction.getTitle 仍將返回空字串。

如果 title 為 null

• 如果指定了 tabId，並且該標籤頁設定了特定於標籤頁的標題，那麼該標籤頁將繼承其所屬視窗的標題。
• 如果指定了 windowId，並且該視窗設定了特定於視窗的標題，那麼該視窗將繼承全域性標題。
• 否則，全域性標題將重置為 manifest 標題。

tabId 可選

integer。僅為給定的標籤頁設定標題。

windowId 可選

integer。設定給定視窗的標題。

• 如果同時提供了 windowId 和 tabId，則函式會失敗，標題不會被設定。
• 如果同時省略了 windowId 和 tabId，則會設定全域性標題。

示例

此程式碼在使用者每次點選瀏覽器操作時，在“this”和“that”之間切換標題。

function toggleTitle(title) {
  if (title === "this") {
    browser.browserAction.setTitle({ title: "that" });
  } else {
    browser.browserAction.setTitle({ title: "this" });
  }
}

browser.browserAction.onClicked.addListener(() => {
  let gettingTitle = browser.browserAction.getTitle({});
  gettingTitle.then(toggleTitle);
});

擴充套件程式示例

• bookmark-it

瀏覽器相容性