bookmarks.getSubTree()
Thebookmarks.getSubTree() method asynchronously retrieves abookmarks.BookmarkTreeNode, given its ID.
If the item is a folder, you can access all its descendants recursively using itschildren property and thechildren property of its descendants, if they are themselves folders.
This is an asynchronous function that returns aPromise.
Syntax
let gettingSubTree = browser.bookmarks.getSubTree( id // string)Parameters
Return value
APromise that is fulfilled with an array containing an object, abookmarks.BookmarkTreeNode object, representing the item with the given ID.
If a node corresponding toid could not be found, the promise will be rejected with an error message.
Examples
This example recursively prints out the subtree under a given node:
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 compatibility
Note:This API is based on Chromium'schrome.bookmarks API. This documentation is derived frombookmarks.json in the Chromium code.