bookmarks.move() は、指定した BookmarkTreeNode をブックマークツリー内の所望の位置に移すメソッドです。このメソッドにより、ブックマークを新しいフォルダの中や、同じフォルダ内の別の場所に移動させることができます。

構文

browser.bookmarks.move(
  id,          // 文字列
  destination, // オブジェクト
  callback     // 関数(省略可)
)

引数

id
移動させるブックマーク / フォルダの ID を表す string です。
destination
ブックマークの移動先を表す object です。このオブジェクトには以下のプロパティが必ず 1 つ以上含まれます。
parentId Optional
移動先フォルダの ID を指定する string です。この値が省略された場合、現在と同じフォルダ内の新しい場所へ移動されます。
index Optional
移動先フォルダ内における位置を指定する 0 起点のインデックスです。値が 0 の場合、そのフォルダの先頭に移動されます。値が省略された場合、新しい親フォルダ内の最後に移動されます。
callback Optional
移動が終了した際に呼び出される function です。この関数は以下の引数を 1 つ受け取ります。
result
移動された新しいノードを表す BookmarkTreeNode

 

ブラウザ実装状況

Chrome Edge Firefox Firefox for Android Opera
Basic Support Yes No 45.0 No 33

使用例

ブックマークを現在のフォルダの先頭へ移動

次の例は、既存のブックマークを現在のフォルダの先頭へ移動させるものです。移動後に必要な処理は特にないため、ここではコールバック無しで呼び出しています。

browser.bookmarks.move(bookmarkID, { index: 0 });

ブックマークを異なるフォルダへ移動

以下の例は、ID で指定したブックマークを、別の ID で指定したフォルダへ移動させる関数です。今回は、移動後に実行されるコールバック関数も指定しています。

function moveToFolder(bookmarkId, destinationId) {
  browser.bookmarks.move(bookmarkId, { parentId: destinationId },
                         function(updatedNode) {
    /* ブックマークの移動後に行う処理 */
  });
}

謝辞

この API は Chromium chrome.bookmarks API に基づいています。また、このドキュメントbookmarks.json における Chromium のコードから作成されています。

Microsoft Edge の実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従います。

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

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