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