bookmarks.update()

Syntax

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

Parameter

id

Ein String, der die ID des zu aktualisierenden Lesezeichens oder des Lesezeichenordners angibt.

changes

Ein Object, der die anzuwendenden Änderungen spezifiziert, mit einer Kombination der folgenden Felder. Alle nicht spezifizierten Elemente werden im referenzierten Lesezeichen oder Ordner nicht verändert:

title Optional

Ein String, der den neuen Titel des Lesezeichens oder den neuen Namen des Ordners enthält, wenn id sich auf einen Ordner bezieht.

url Optional

Ein String, der 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 darstellt. 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