sidebarAction.getTitle()

獲取側邊欄的標題。

正如您可以使用 sidebarAction.setTitle() 按標籤頁設定標題一樣,您也可以透過將標籤頁 ID 傳遞給此函式來檢索特定於標籤頁的標題。

這是一個非同步函式,返回一個 Promise

語法

js
let gettingTitle = browser.sidebarAction.getTitle(
  details               // object
)

引數

details

object。一個具有以下屬性的物件。

tabId 可選

integer。 獲取特定於給定標籤頁的側邊欄標題。

windowId 可選

integer。 獲取特定於給定視窗的側邊欄標題。

  • 如果同時提供了 windowIdtabId,則函式將失敗,並且它返回的 Promise 將被拒絕。
  • 如果同時省略了 windowIdtabId,則返回全域性標題。

返回值

一個 Promise,它將以包含側邊欄標題的字串來履行。

示例

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

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

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

瀏覽器相容性

注意:此 API 基於 Opera 的 chrome.sidebarAction API。