← 返回首页

BackgroundFetchUpdateUIEvent.updateUI() - Web API | MDN

Toggle sidebar

Theme

OS default
Light
Dark

日本語

Remember language Learn more

BackgroundFetchUpdateUIEvent.updateUI()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

BackgroundFetchUpdateUIEvent インターフェイスの updateUI() メソッドは、 UI 上のタイトルとアイコンを更新し、バックグラウンドのフェッチの成否を表示します。

このメソッドは一度だけ実行され、フェッチの成否をユーザーに通知することができます。

In this article

構文

js

updateUI(options)

引数

options 省略可

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

icons 省略可

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

src

画像のURL文字列。

sizes 省略可

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

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

label 省略可

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

title 省略可

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

返値

例外

InvalidStateError DOMException

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

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

例

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

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

仕様書

Specification

Background Fetch
# background-fetch-update-ui-event-update-ui

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年6月24日 by MDN contributors.

View this page on GitHub • Report a problem with this content

バックグラウンドフェッチ API
BackgroundFetchUpdateUIEvent
コンストラクター
1. BackgroundFetchUpdateUIEvent()
インスタンスメソッド
1. updateUI()
継承
Background Fetch API に関連するページ