bookmarks.remove()

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

警告： 如果你的扩展尝试从书签树的根节点中移除一个书签，该调用将会引发一个“书签根不能被修改的”的错误信息并且这个书签不会被移除。

这是一个返回 Promise 的异步函数。

语法

js
var removingBookmark = browser.bookmarks.remove(
  id, // 字符串
);

参数

id

一个指定要移除的书签或空文件夹的 ID 的字符串。

返回值

一个 Promise，其不会兑现任何参数。

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

示例

js
function onRemoved() {
  console.log("已移除！");
}

function onRejected(error) {
  console.log(`出现错误：${error}`);
}

let bookmarkId = "abcdefghijkl";

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

示例扩展

浏览器兼容性

备注： 此 API 基于 Chromium 的 chrome.bookmarks API。该文档衍生自 Chromium 代码中的 bookmarks.json。