bookmarks.getSubTree()

**bookmarks.getSubTree()** 方法异步检索一个 bookmarks.BookmarkTreeNode，其 ID 为参数。

如果该项目是一个文件夹，您可以使用其 children 属性及其后代的 children 属性（如果它们本身也是文件夹）递归访问其所有后代。

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

语法

js
let gettingSubTree = browser.bookmarks.getSubTree(
  id                     // string
)

参数

id

一个 string，指定要检索的子树根部的 ID。

返回值

一个 Promise，其结果是一个包含一个对象的数组，一个 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);

浏览器兼容性

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

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