bookmarks.onChanged
Fired when there is a change to:
Fired when there is a change to:
- the title or URL of a bookmark
- the name of a folder.
Syntax
browser.bookmarks.onChanged.addListener(listener)
browser.bookmarks.onChanged.removeListener(listener)
browser.bookmarks.onChanged.hasListener(listener)
Events have three functions:
addListener(listener)- : Adds a listener to this event.
removeListener(listener)- : Stop listening to this event. The
listenerargument is the listener to remove. hasListener(listener)- : Check whether
listeneris registered for this event. Returnstrueif it is listening,falseotherwise.
addListener syntax
Parameters
listener- : The function called when this event occurs. The function is passed these arguments:
id- :
string. ID of the item that changed. changeInfo- :
object. Object containing two properties:title, a string containing the item's title, andurl, a string containing the item's URL. If the item is a folder,urlis omitted.
[!NOTE] Multiple events may occur when a bookmark changes, and that changeInfo object may contain only the data that has changed, rather than all the data for the bookmark. In other words, if the
urlfor a bookmark changes, the changeInfo may only contain the newurlinformation.
Examples
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);
Browser compatibility
[!NOTE] This API is based on Chromium's
chrome.bookmarksAPI. This documentation is derived frombookmarks.jsonin the Chromium code.