history.onTitleChanged

当用户访问的页面的标题被记录时触发。要监听对页面的访问，您使用 history.onVisited。但是，此事件传递给其监听器的 history.HistoryItem 不包含页面标题，因为通常在发送 history.onVisited 时不知道页面标题。相反，存储的 history.HistoryItem 在页面加载后，一旦知道标题，就会使用页面标题更新。history.onTitleChanged 事件在此时触发。因此，如果您需要了解页面访问时的标题，请监听 history.onTitleChanged。

语法

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 语法

参数

listener

当此事件发生时调用的函数。该函数传递一个具有以下属性的对象

id: String。与本次访问相关的 history.HistoryItem 的唯一标识符。
url: String。访问的页面的 URL。
title: String。访问的页面的标题。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例

监听标题更改事件，并记录已访问页面的 ID、URL 和标题。

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。