bookmarks.getChildren()

bookmarks.getChildren() 方法检索由 BookmarkTreeNode ID 标识的书签文件夹的所有直接子节点。

这是一个返回 Promise 的异步函数。

语法

js
let gettingChildren = browser.bookmarks.getChildren(
  id                     // string
)

参数

id

一个字符串,指定要检索其子节点的文件夹的 ID。

返回值

一个 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