bookmarks.update()

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

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

構文

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)" にリネームするものです。

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