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 オブジェクトです。

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
update

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

使用例

フォルダーのリネーム

以下の例は、"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 に従います。