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 "Das Lesezeichenwurzel kann nicht geändert werden" ausgegeben 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 zu aktualisierenden Lesezeichens oder Lesezeichenordners angibt.

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 oder den neuen Namen des Ordners enthält, wenn sich id 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 zum id-Parameter gehörende Lesezeichenelement 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

BCD tables only load in the browser

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