webNavigation.onReferenceFragmentUpdated
當頁面的片段識別符號更改時觸發。例如，如果一個頁面使用片段實現了目錄，並且使用者點選了目錄中的一個條目，就會觸發此事件。此框架的所有後續事件都將使用更新後的 URL。
語法
browser.webNavigation.onReferenceFragmentUpdated.addListener(
listener, // function
filter // optional object
)
browser.webNavigation.onReferenceFragmentUpdated.removeListener(listener)
browser.webNavigation.onReferenceFragmentUpdated.hasListener(listener)
事件有三個函式
addListener(listener)-
向此事件新增監聽器。
removeListener(listener)-
停止監聽此事件。
listener引數是要移除的監聽器。 hasListener(listener)-
檢查
listener是否已為此事件註冊。如果正在監聽，則返回true，否則返回false。
addListener 語法
引數
監聽器-
當此事件發生時呼叫的函式。該函式將傳遞此引數
filter可選-
object。一個包含單個屬性url的物件，該屬性是一個Array，其中包含events.UrlFilter物件。如果您包含此引數，則僅在導航到至少一個與陣列中的UrlFilter匹配的URL時才會觸發該事件。如果省略此引數，則在所有導航時都會觸發該事件。
額外物件
details
tabId-
integer。導航即將發生的選項卡ID。 url-
string。給定框架將導航到的URL。 processId可選 已棄用-
integer。此值在現代瀏覽器中未設定。當設定時，它代表執行此選項卡渲染器的程序ID。 frameId-
integer。導航將發生的框架。0表示導航發生在選項卡的主瀏覽上下文，而不是巢狀的<iframe>中。正值表示導航發生在巢狀的iframe中。對於給定的選項卡和程序，框架ID是唯一的。 parentFrameId-
integer。此框架父級的ID。如果這是頂層框架，則設定為-1。 timeStamp-
number。片段識別符號更改頁面的時間，以自紀元以來的毫秒數為單位。 transitionType-
transitionType。導航的原因：例如，如果是使用者點選連結，則為"link"。 transitionQualifiers-
ArrayoftransitionQualifier。有關導航的附加資訊：例如，是否存在伺服器端或客戶端重定向。
示例
為 onReferenceFragmentUpdated 記錄目標 URL 和額外的過渡資訊，前提是目標 URL 的主機名包含 "example.com" 或以 "developer" 開頭。
const filter = {
url: [{ hostContains: "example.com" }, { hostPrefix: "developer" }],
};
function logOnReferenceFragmentUpdated(details) {
console.log(`onReferenceFragmentUpdated: ${details.url}`);
console.log(`Transition type: ${details.transitionType}`);
console.log(`Transition qualifiers: ${details.transitionQualifiers}`);
}
browser.webNavigation.onReferenceFragmentUpdated.addListener(
logOnReferenceFragmentUpdated,
filter,
);
瀏覽器相容性
載入中…
注意：此API基於Chromium的chrome.webNavigation API。本文件源自Chromium程式碼中的web_navigation.json。