bookmarks.get()

给定一个 bookmarks.BookmarkTreeNode 的 ID 或一个包含此类 ID 的数组,bookmarks.get() 方法将检索匹配的节点。

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

语法

js
let getBookmarks = browser.bookmarks.get(
  idOrIdList                // string or string array
)

参数

idOrIdList

一个 stringarray,指定要检索的一个或多个 BookmarkTreeNode 对象的 ID。

返回值

一个 Promise,它将使用 BookmarkTreeNode 数组完成,每个数组元素对应一个匹配的节点。结果中不包含分隔符。如果找不到任何节点,则 Promise 将使用错误消息拒绝。

示例

此示例尝试获取 ID 为 bookmarkAAAA 的书签。如果不存在此 ID 的书签,则会调用 onRejected

js
function onFulfilled(bookmarks) {
  console.log(bookmarks);
}

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

let gettingBookmarks = browser.bookmarks.get("bookmarkAAAA");
gettingBookmarks.then(onFulfilled, onRejected);

浏览器兼容性

BCD 表格仅在浏览器中加载

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