bookmarks.update()

bookmarks.update() aktualisiert den Titel und/oder die URL eines Lesezeichens oder den Namen eines Lesezeichenordners.

Warnung: Wenn Ihre Erweiterung versucht, ein Lesezeichen im Wurzelknoten des Lesezeichenbaums zu aktualisieren, wird ein Fehler mit der Nachricht: "Der Lesezeichenstamm kann nicht geändert werden" ausgelöst, und das Lesezeichen wird nicht aktualisiert.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

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

Parameter

id

Ein string, das die ID des Lesezeichens oder des Lesezeichenordners angibt, das bzw. der aktualisiert werden soll.

changes

Ein object, das die anzuwendenden Änderungen angibt, mit einer Kombination der folgenden Felder. Alle nicht angegebenen Elemente werden im referenzierten Lesezeichen oder Ordner nicht geändert:

title Optional

Ein string, das den neuen Titel des Lesezeichens enthält oder den neuen Namen des Ordners, falls id sich auf einen Ordner bezieht.

url Optional

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

Rückgabewert

Ein Promise, das mit einem einzigen 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.

js
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

Hinweis: Diese API basiert auf der chrome.bookmarks-API von Chromium. Diese Dokumentation stammt aus bookmarks.json im Chromium-Code.