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。