bookmarks.onChanged
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(callback)
-
Adds a listener to this event.
removeListener(listener)
-
Stop listening to this event. The
listener
argument is the listener to remove. hasListener(listener)
-
Check whether
listener
is registered for this event. Returnstrue
if it is listening,false
otherwise.
addListener syntax
Parameters
callback
-
Function that will be called when this event occurs. The function will be passed the following 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,url
is 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 url
for a bookmark changes, the changeInfo may only contain the new url
information.
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
BCD tables only load in the browser
Note: This API is based on Chromium's chrome.bookmarks
API. This documentation is derived from bookmarks.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.