bookmarks.getChildren()
bookmarks.getChildren()
方法检索由 BookmarkTreeNode
ID 标识的书签文件夹的所有直接子节点。
这是一个返回 Promise
的异步函数。
语法
js
let gettingChildren = browser.bookmarks.getChildren(
id // string
)
参数
返回值
一个 Promise
,其会兑现一个 BookmarkTreeNode
对象数组。每个条目代表一个子节点。列表的顺序与书签在用户界面中出现的顺序相同。结果中包括分隔符。列表包括子文件夹,但不包括子文件夹中的任何子节点。
如果指定的节点没有子节点,则数组为空。
如果找不到由 id
标识的节点,则 Promise 会以一条错误消息拒绝。
示例
js
function onFulfilled(children) {
for (child of children) {
console.log(child.id);
}
}
function onRejected(error) {
console.log(`发生错误:${error}`);
}
let gettingChildren = browser.bookmarks.getChildren("unfiled_____");
gettingChildren.then(onFulfilled, onRejected);
浏览器兼容性
BCD tables only load in the browser
备注:此 API 基于 Chromium 的 chrome.bookmarks
API。该文档衍生自 Chromium 代码中的 bookmarks.json
。