bookmarks.update()

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

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

構文

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

引数

id

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

changes

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

title省略可

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

url省略可

ブックマークの新しい URL を指定する string です。

callback省略可

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

result

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

ブラウザーの互換性

BCD tables only load in the browser

使用例

フォルダーのリネーム

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

js
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.Microsoft Edge の実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従います。