bookmarks.getChildren()

bookmarks.getChildren() 用于检索书签文件夹的所有直接子级,该文件夹由 BookmarkTreeNode ID 标识。

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

语法

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

参数

id

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

返回值

一个 Promise,该 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);

浏览器兼容性

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