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

浏览器兼容性

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