bookmarks.getSubTree()

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

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

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

Syntax

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

Parameter

id

Eine string, die die ID der Wurzel des abzurufenden Teilbaums angibt.

Rückgabewert

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

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

Beispiele

Dieses Beispiel gibt rekursiv den Teilbaum unter einem bestimmten Knoten aus:

js
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

BCD tables only load in the browser

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