bookmarks.removeTree()
bookmarks.removeTree() 方法会递归地删除书签文件夹及其所有内容。
警告: 如果您的扩展程序尝试从书签树根节点删除书签树,该调用将引发一个错误,消息为:“书签根目录无法修改”,并且书签不会被删除。
这是一个异步函数,返回一个 Promise。
语法
js
let removingTree = browser.bookmarks.removeTree(
id // string
)
参数
返回值
一个 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。