bookmarks.remove()

The bookmarks.remove() method removes a single bookmark or an empty bookmark folder.

警告: 如果你的扩展尝试从书签树的根节点删除书签，该调用会引发错误，错误消息为：“无法修改书签根节点”，并且书签不会被删除。

这是一个异步函数，它返回一个 Promise.

语法

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

参数

id

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

返回值

一个 Promise，它将被无参数完成。

如果与 id 参数相对应的节点找不到或是非空文件夹，则 Promise 会被错误消息拒绝。

示例

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

示例扩展

浏览器兼容性

BCD 表格只在浏览器中加载

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