bookmarks.removeTree()

bookmarks.removeTree() 方法会递归地删除书签文件夹及其所有内容。

警告: 如果您的扩展程序尝试从书签树根节点删除书签树,该调用将引发一个错误,消息为:“书签根目录无法修改”,并且书签不会被删除。

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

语法

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

参数

id

一个 string,指定要删除的文件夹节点的 ID 及其后代。

返回值

一个 Promise,当树已被移除时,它将以无参数的形式 fulfilled。

如果找不到与 id 参数对应的节点,Promise 将以错误消息被 rejected。

示例

此示例将找到一个名为“MDN”的书签文件夹,并将其连同所有内容一起删除。

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

浏览器兼容性

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