bookmarks.getSubTree()
bookmarks.getSubTree() 方法会根据提供的 ID,异步检索一个 bookmarks.BookmarkTreeNode 对象。
如果该项是文件夹,您可以通过其 children 属性以及其后代(如果它们本身也是文件夹)的 children 属性来递归访问其所有后代。
这是一个异步函数,返回一个 Promise。
语法
js
let gettingSubTree = browser.bookmarks.getSubTree(
id // string
)
参数
返回值
一个 Promise,它会以一个包含一个对象的数组来 fulfilled,该对象是一个 bookmarks.BookmarkTreeNode 对象,代表具有给定 ID 的项。
如果找不到与 id 对应的节点,Promise 将会因错误消息而被拒绝。
示例
此示例递归打印给定节点下的子树
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);
浏览器兼容性
加载中…
注意: 此 API 基于 Chromium 的 chrome.bookmarks API。本文档摘自 Chromium 代码中的 bookmarks.json。