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
let gettingSubTree = browser.bookmarks.getSubTree(
id // string
)
Parameter
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:
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.