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

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

構文

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

引数

id
更新したいブックマーク / フォルダの ID を表す string です。
changes
適用したい変更内容を表す object であり、以下のプロパティから構成されます。指定しなかったプロパティについて、ブックマークやフォルダが変更されることはありません。
 
titleOptional
id がフォルダを表す場合、ブックマークの新しいタイトル / フォルダの新しい名前を指定する string です。
urlOptional
ブックマークの新しい URL を指定する string です。
callbackOptional
変更が適用された際に実行される関数です。この関数には次の引数が 1 つ渡ります。
result
更新されたブックマークを表すbookmarks.BookmarkTreeNode オブジェクトです。

ブラウザ実装状況

Chrome Edge Firefox Firefox for Android Opera
Basic Support Yes No 45.0 No 33

使用例

フォルダのリネーム

以下の例は、"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);

Acknowledgements

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

ドキュメントのタグと貢献者

 最終更新者: hashedhyphen,