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