bookmarks.move()

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

構文

js

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

引数

id

移動させるブックマーク / フォルダの ID を表す string です。

destination

ブックマークの移動先を表す object です。このオブジェクトには以下のプロパティが必ず 1 つ以上含まれます。

parentId 省略可

移動先フォルダの ID を指定する string です。この値が省略された場合、現在と同じフォルダ内の新しい場所へ移動されます。

index 省略可

移動先フォルダ内における位置を指定する 0 起点のインデックスです。値が 0 の場合、そのフォルダの先頭に移動されます。値が省略された場合、新しい親フォルダ内の最後に移動されます。

callback 省略可

移動が終了した際に呼び出される function です。この関数は以下の引数を 1 つ受け取ります。

result

移動された新しいノードを表す BookmarkTreeNode

ブラウザーの互換性

BCD tables only load in the browser

使用例

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

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

js

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

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

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

js

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