BackgroundFetchUpdateUIEvent.updateUI()

構文

updateUI(options)

引数

options 省略可

下記のいずれかを含むオブジェクト。

icons 省略可

UI で用いるアイコンを含む、 1 枚以上の画像リソースのリストです。画像リソースは下記の情報を持つオブジェクトです。

src

画像のURL文字列。

sizes 省略可

<link> sizes 属性と同じ意味を持つ文字列。

type 省略可

画像の MIME タイプを含む文字列。

label 省略可

画像の名前を指定する文字列。

title 省略可

UI の新しいタイトルを指定する文字列。

返値

Promise 。

例外

InvalidStateError DOMException

以下のいずれかに当てはまるとき、発生します。

• isTrusted プロパティが false のとき。
• BackgroundFetchUpdateUIEvent UI 更新のフラグがすでにセットされている、すなわち、すでに updateUI() メソッドが呼ばれたあとであるとき。
• BackgroundFetchUpdateUIEvent がアクティブではないとき。

例

以下の例では、フェッチ成功時に UI のタイトルとアイコン画像を更新しています。

addEventListener("backgroundfetchsuccess", (event) => {
  event.updateUI({
    title: "Episode 5 ready to listen!",
    icon: {
      src: "path/to/success.ico",
      sizes: "16x16 32x32 64x64",
    },
  });
});

仕様書

ブラウザーの互換性