このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
bookmarks.getSubTree()
bookmarks.getSubTree() は、ID を指定してbookmarks.BookmarkTreeNode を非同期に取得するメソッドです。
対象がフォルダーの場合、children プロパティを再帰的にたどることで、すべての子要素にアクセスすることができます。
構文
js
browser.bookmarks.getSubTree( id, // 文字列 callback, // 関数);引数
id取得したい部分木のルートノードに対応する ID を表す
stringです。callbackリクエストしたノードが取得された際に呼び出される関数です。この関数には以下の引数が渡ります。
results指定した ID に対応する
bookmarks.BookmarkTreeNodeオブジェクトが 1 つ含まれた配列
ブラウザーの互換性
例
以下の例は、指定したノードの配下にある部分木を再帰的に出力するものです。
js
function makeIndent(indentLength) { return ".".repeat(indentLength);}function logItems(bookmarkItem, indent) { if (bookmarkItem.url) { console.log(makeIndent(indent) + bookmarkItem.url); } else { console.log(makeIndent(indent) + "Folder"); indent++; } if (bookmarkItem.children) { for (child of bookmarkItem.children) { logItems(child, indent); } } indent--;}function logSubTree(bookmarkItems) { logItems(bookmarkItems[0], 0);}function handleClick() { var subTreeID = "unfiled_____"; chrome.bookmarks.getSubTree(subTreeID, logSubTree);}chrome.browserAction.onClicked.addListener(handleClick);メモ:この API は Chromium のchrome.bookmarks API に基づいています。また、このドキュメントはbookmarks.json における Chromium のコードから作成されています。