bookmarks.getSubTree()

Die Methode bookmarks.getSubTree() ruft asynchron einen bookmarks.BookmarkTreeNode ab, basierend auf ihrer ID.

Wenn das Element ein Ordner ist, können Sie rekursiv auf alle seine Nachkommen über die Eigenschaft children und die children-Eigenschaft seiner Nachkommen zugreifen, falls diese selbst Ordner sind.

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

Syntax

let gettingSubTree = browser.bookmarks.getSubTree(
  id                     // string
)

Parameter

id: Ein string, das die ID der Wurzel des abzurufenden Unterbaums angibt.

Rückgabewert

Ein Promise, das mit einem Array erfüllt wird, das ein Objekt enthält, ein bookmarks.BookmarkTreeNode-Objekt, das das Element mit der angegebenen ID darstellt.

Wenn ein Knoten, der der id entspricht, nicht gefunden werden konnte, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Dieses Beispiel gibt den Unterbaum unter einem gegebenen Knoten rekursiv aus:

function makeIndent(indentLength) {
  return ".".repeat(indentLength);
}

function logItems(bookmarkItem, indent) {
  if (bookmarkItem.url) {
    console.log(makeIndent(indent) + bookmarkItem.url);
  } else {
    console.log(`${makeIndent(indent)}Folder: ${bookmarkItem.id}`);
    indent++;
  }
  if (bookmarkItem.children) {
    for (const child of bookmarkItem.children) {
      logItems(child, indent);
    }
  }
}

function logSubTree(bookmarkItems) {
  logItems(bookmarkItems[0], 0);
}

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

let subTreeID = "root_____";

browser.bookmarks.getSubTree(subTreeID).then(logSubTree, onRejected);

Browser-Kompatibilität

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