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 がセットされます。

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
get

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

使用例

以下の例は、特定の 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 に従います。