bookmarks.update()

Syntax

let updating = browser.bookmarks.update(
  id,                    // string
  changes                // object
)

Parameter

id

Eine string, die die ID des zu aktualisierenden Lesezeichens oder Lesezeichenordners angibt.

changes

Ein object, der die anzuwendenden Änderungen angibt, wobei eine Kombination der folgenden Felder verwendet wird. Alle nicht angegebenen Elemente werden in dem referenzierten Lesezeichen oder Ordner nicht geändert:

title Optional

Eine string, die den neuen Titel des Lesezeichens enthält oder den neuen Namen des Ordners, wenn id sich auf einen Ordner bezieht.

url Optional

Eine string, die eine neue URL für das Lesezeichen bereitstellt.

Rückgabewert

Ein Promise, das mit einem einzelnen bookmarks.BookmarkTreeNode-Objekt erfüllt wird, das das aktualisierte Lesezeichen repräsentiert. Wenn das Lesezeichenelement, das dem id-Parameter entspricht, nicht gefunden werden kann, wird das Promise abgelehnt.

Beispiele

Dieses Beispiel benennt alle Ordner mit dem Namen "MDN" in "Mozilla Developer Network (MDN)" um.

function onFulfilled(bookmarkItem) {
  console.log(bookmarkItem.title);
}

function onRejected(error) {
  console.error(`Error: ${error}`);
}

function updateFolders(items) {
  for (const item of items) {
    // only folders, so skip items with a `url`
    if (!item.url) {
      browser.bookmarks
        .update(item.id, {
          title: "Mozilla Developer Network (MDN)",
        })
        .then(onFulfilled, onRejected);
    }
  }
}

browser.bookmarks.search({ title: "MDN" }).then(updateFolders, onRejected);

Browser-Kompatibilität