action.getTitle()
獲取瀏覽器操作的標題。
注意:此 API 在 Manifest V3 或更高版本中可用。
就像您可以使用 action.setTitle() 按標籤頁設定標題一樣,您也可以透過將標籤頁的 ID 傳遞給此函式來檢索特定於標籤頁的標題。
這是一個非同步函式,返回一個 Promise。
語法
js
let gettingTitle = browser.action.getTitle(
details // object
)
引數
details-
具有以下屬性的物件:
tabId可選-
integer。指定要從中獲取標題的標籤頁。 windowId可選-
integer。指定要從中獲取標題的視窗。
- 如果同時提供了
windowId和tabId,則函式將失敗,並且它返回的 Promise 將被拒絕。 - 如果同時省略了
windowId和tabId,則返回全域性標題。
返回值
一個 Promise,它將以包含瀏覽器操作標題的字串來兌現。
示例
此程式碼在使用者每次點選瀏覽器操作時,在“this”和“that”之間切換標題。
js
function toggleTitle(title) {
if (title === "this") {
browser.action.setTitle({ title: "that" });
} else {
browser.action.setTitle({ title: "this" });
}
}
browser.action.onClicked.addListener(() => {
let gettingTitle = browser.action.getTitle({});
gettingTitle.then(toggleTitle);
});
瀏覽器相容性
載入中…
注意:此 API 基於 Chromium 的 chrome.action API。本文件源自 Chromium 程式碼中的 browser_action.json。