Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 auf alle seine Nachkommen rekursiv über seine children-Eigenschaft und die children-Eigenschaft seiner Nachkommen zugreifen, sofern diese selbst Ordner sind.

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

Syntax

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

Parameter

id

Ein String, der die ID des Wurzelelements 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 entsprechend der id nicht gefunden werden konnte, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Dieses Beispiel gibt rekursiv den Unterbaum unter einem gegebenen 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

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