bookmarks.getChildren()

bookmarks.getChildren()检索书签文件夹的所有直接子项,这些子项被标识为BookmarkTreeNode ID。

这是一个异步函数,它返回一个Promise

语法

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

参数

id

一个string,指定要检索其子项的文件夹的 ID。

返回值

一个Promise,它将解析为一个BookmarkTreeNode对象的数组。每个条目表示一个子节点。列表的顺序与书签在用户界面中显示的顺序相同。结果中包含分隔符。列表包含子文件夹,但不包含子文件夹中包含的任何子项。

如果指定的节点没有子项,则数组为空。

如果找不到 id 指定的节点,则 promise 将被拒绝并显示错误消息。

示例

js
function onFulfilled(children) {
  for (child of children) {
    console.log(child.id);
  }
}

function onRejected(error) {
  console.log(`An error: ${error}`);
}

let gettingChildren = browser.bookmarks.getChildren("unfiled_____");
gettingChildren.then(onFulfilled, onRejected);

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

注意:此 API 基于 Chromium 的chrome.bookmarks API。本文档源自 Chromium 代码中的bookmarks.json