history.onTitleChanged
當用戶訪問的頁面的標題被記錄時觸發。要監聽頁面訪問,可以使用 history.onVisited。但是,此事件傳遞給監聽器的 history.HistoryItem 不包含頁面標題,因為頁面標題在傳送 history.onVisited 時通常是未知的。相反,一旦頁面載入並知道了標題,已儲存的 history.HistoryItem 就會使用頁面標題進行更新。此時會觸發 history.onTitleChanged 事件。因此,如果您需要知道頁面訪問時的標題,請監聽 history.onTitleChanged。
語法
js
browser.history.onTitleChanged.addListener(listener)
browser.history.onTitleChanged.removeListener(listener)
browser.history.onTitleChanged.hasListener(listener)
事件有三個函式
addListener(listener)-
向此事件新增監聽器。
removeListener(listener)-
停止監聽此事件。
listener引數是要移除的監聽器。 hasListener(listener)-
檢查
listener是否已為此事件註冊。如果正在監聽,則返回true,否則返回false。
addListener 語法
引數
監聽器-
發生此事件時呼叫的函式。該函式會接收一個包含以下屬性的物件
id-
String。與此訪問關聯的history.HistoryItem的唯一識別符號。 url-
String。訪問頁面的 URL。 title-
String。訪問頁面的標題。
示例
監聽標題更改事件,並記錄訪問頁面的 ID、URL 和標題。
js
function handleTitleChanged(item) {
console.log(item.id);
console.log(item.title);
console.log(item.url);
}
browser.history.onTitleChanged.addListener(handleTitleChanged);
瀏覽器相容性
載入中…
注意: 此 API 基於 Chromium 的 chrome.history API。本文件源自 Chromium 程式碼中的 history.json。