bookmarks.removeTree()

Метод bookmarks.removeTree() рекурсивно удаляет папку закладок и все её содержимое.

Предупреждение: Если расширение пытается удалить дерево закладок из корневого узла дерева закладок, вызов вызовет ошибку с сообщением: «Корень закладок не может быть изменён», и закладки не будут удалены.

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

Синтаксис

let removingTree = browser.bookmarks.removeTree(
  id                // string
)

Параметры

id: string, определяющий идентификатор узла папки, который будет удалён вместе со своими потомками.

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

A Promise, который будет выполнен без аргументов, когда дерево будет удалено.

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

Примеры

В этом примере находится папка закладок с именем «MDN» и удаляется вместе со всем её содержимым.

function onRemoved() {
  console.log("bookmark item removed!");
}

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

function removeMDN(searchResults) {
  if (searchResults.length) {
    let removing = browser.bookmarks.removeTree(searchResults[0].id);
    removing.then(onRemoved, onRejected);
  }
}

let searchingBookmarks = browser.bookmarks.search({ title: "MDN" });
searchingBookmarks.then(removeMDN, onRejected);

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

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

Примечание: Этот 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/removeTree