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

構文

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

引数

idOrIdList
取得したい BookmarkTreeNode オブジェクトの ID を指定した string または string の {[jsxref("array")}} です。
callback
ノードが取得された際に実行される function です。この関数には以下の引数が渡ります。
results
各要素が bookmarks.BookmarkTreeNode である、マッチしたノードの array です。セパレータは結果の戻り値に含まれません。ノードが見つからなかった場合の resultsundefined となり、runtime.lastError がセットされます。

ブラウザ実装状況

ChromeEdgeFirefoxFirefox for AndroidOpera
基本対応 あり なし45 なし あり

使用例

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

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 に従います。

ドキュメントのタグと貢献者

このページの貢献者: hashedhyphen
最終更新者: hashedhyphen,