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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
getSubTree

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

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