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