bookmarks.get()

bookmarks.get() 方法用于检索与给定 bookmarks.BookmarkTreeNode 的 ID 或此类 ID 的数组匹配的节点。

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

语法

js
let getBookmarks = browser.bookmarks.get(
  idOrIdList                // 字符串或字符串数组
)

参数

idOrIdList

一个字符串或字符串数组，指定一个或多个要检索的 BookmarkTreeNode 对象的 ID。

返回值

一个 Promise，其会兑现一个 BookmarkTreeNode 数组，表示每个匹配的节点。结果中不包括分隔符。如果找不到任何节点，promise 将以错误消息拒绝。

示例

此示例尝试获取 ID 为 bookmarkAAAA 的书签。如果不存在具有此 ID 的书签，则调用 onRejected：

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

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

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

浏览器兼容性

BCD tables only load in the browser

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