bookmarks.getSubTree()

Метод bookmarks.getSubTree() асинхронно извлекает bookmarks.BookmarkTreeNode, заданный его ID.

Если элемент является папкой, вы можете получить доступ ко всем его потомкам рекурсивно, используя свойство children и свойство children его потомков, если они также являются папками.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

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

Параметры

id: string, определяющий ID корня поддерева для извлечения.

Возвращаемое значение

A Promise, который будет выполнен с массивом, содержащим один объект, объект bookmarks.BookmarkTreeNode, представляющий элемент с заданным ID.

Если узел, соответствующий id, не найден, обещание будет отклонено с сообщением об ошибке.

Примеры

В этом примере рекурсивно выводится поддерево под заданным узлом:

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);

Совместимость с браузерами

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`getSubTree`	Да	79	45	?	Да	Нет	?	?	Нет	?	Нет	?

Примечание: Этот API основан на API chrome.bookmarks от Chromium. Данная документация взята из bookmarks.json в коде Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks/getSubTree