bookmarks.update()

bookmarks.update() は、ブックマークの URL やタイトル、またはフォルダーの名前を更新するメソッドです。

ブックマーク要素が見つからなかった場合には runtime.lastError がセットされるので、エラーの有無をコールバックで確認できます。

構文

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

引数

id

更新したいブックマーク / フォルダーの ID を表す string です。

changes

適用したい変更内容を表す object であり、以下のプロパティから構成されます。指定しなかったプロパティについて、ブックマークやフォルダーが変更されることはありません。

title省略可: id がフォルダーを表す場合、ブックマークの新しいタイトル / フォルダーの新しい名前を指定する string です。
url省略可: ブックマークの新しい URL を指定する string です。

callback省略可

変更が適用された際に実行される関数です。この関数には次の引数が 1 つ渡ります。

result: 更新されたブックマークを表すbookmarks.BookmarkTreeNode オブジェクトです。

ブラウザーの互換性

使用例

フォルダーのリネーム

以下の例は、"MDN" という名前のフォルダーすべてを "MDN" to "Mozilla Developer Network (MDN)" にリネームするものです。

function updateFolders(items) {
  for (item of items) {
    // only folders, so skip items with a `url`
    if (!item.url) {
      chrome.bookmarks.update(item.id, {
        title: "Mozilla Developer Network (MDN)",
      });
    }
  }
}

chrome.bookmarks.search({ title: "MDN" }, updateFolders);

メモ: This API is based on Chromium's chrome.bookmarks API. This documentation is derived from bookmarks.json in the Chromium code.