bookmarks.remove()

bookmarks.remove() 方法用于移除单个书签或空的文件夹。

警告: 如果您的扩展尝试从书签树的根节点移除书签,该调用将抛出错误,消息为:“书签根目录无法修改”,书签也不会被移除。

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

语法

js
let removingBookmark = browser.bookmarks.remove(
  id                 // string
)

参数

id

一个 string,指定要移除的书签或空文件夹的 ID。

返回值

一个 Promise,该 Promise 将以无参数的方式 fulfilled。

如果找不到与 id 参数对应的节点,或者该节点是一个非空文件夹,则 Promise 将会以错误消息被 rejected。

示例

js
function onRemoved() {
  console.log("Removed!");
}

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

let bookmarkId = "abcdefghijkl";

let removingBookmark = browser.bookmarks.remove(bookmarkId);
removingBookmark.then(onRemoved, onRejected);

扩展程序示例

浏览器兼容性

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