bookmarks.get()

bookmarks.get() は、指定した bookmarks.BookmarkTreeNode の ID(または ID の配列)にマッチするノードを取得するメソッドです。

構文

js
browser.bookmarks.get(
  idOrIdList, // 文字列または文字列の配列
  callback, // 関数
);

引数

idOrIdList

取得したい BookmarkTreeNode オブジェクトの ID を指定した string または string の {[jsxref("array")}} です。

callback

ノードが取得された際に実行される function です。この関数には以下の引数が渡ります。

results

各要素が bookmarks.BookmarkTreeNode である、マッチしたノードの array です。セパレータは結果の戻り値に含まれません。ノードが見つからなかった場合の resultsundefined となり、runtime.lastError がセットされます。

ブラウザーの互換性

BCD tables only load in the browser

使用例

以下の例は、特定の ID を持つブックマークが存在するかどうかを確認するものです。

js
function onGot(bookmarkItems) {
  if (bookmarkItems) {
    console.log("bookmark exists!");
  } else {
    console.log("bookmark does not exist!");
    console.log("lasterror: " + chrome.runtime.lastError);
  }
}

function doesBookmarkExist(bookmarkId) {
  browser.bookmarks.get(bookmarkId, onGot);
}

メモ: この API は Chromium の chrome.bookmarks API に基づいています。また、このドキュメントは bookmarks.json における Chromium のコードに基づいて作成されています。Microsoft Edge の実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従います。