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