bookmarks.onChanged

當以下情況發生更改時觸發:

  • 書籤的標題或 URL
  • 資料夾的名稱。

語法

js
browser.bookmarks.onChanged.addListener(listener)
browser.bookmarks.onChanged.removeListener(listener)
browser.bookmarks.onChanged.hasListener(listener)

事件有三個函式

addListener(listener)

向此事件新增監聽器。

removeListener(listener)

停止監聽此事件。listener 引數是要移除的監聽器。

hasListener(listener)

檢查 listener 是否已為此事件註冊。如果正在監聽,則返回 true,否則返回 false

addListener 語法

引數

監聽器

此事件發生時呼叫的函式。該函式會傳遞以下引數:

id

string。已更改項的 ID。

changeInfo

object。一個包含兩個屬性的物件:title(包含項標題的字串)和 url(包含項 URL 的字串)。如果該項是資料夾,則會省略 url

注意:書籤更改時可能會觸發多個事件,並且 changeInfo 物件可能只包含已更改的資料,而不是書籤的所有資料。換句話說,如果書籤的 url 發生更改,changeInfo 可能只包含新的 url 資訊。

示例

js
function handleChanged(id, changeInfo) {
  console.log(`Item: ${id} changed`);
  console.log(`Title: ${changeInfo.title}`);
  console.log(`URL: ${changeInfo.url}`);
}

function handleClick() {
  browser.bookmarks.onChanged.addListener(handleChanged);
}

browser.browserAction.onClicked.addListener(handleClick);

瀏覽器相容性

注意:此 API 基於 Chromium 的 chrome.bookmarks API。本文件源自 Chromium 程式碼中的 bookmarks.json