Get to know MDN better
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Want more support for this feature? Tell us why.
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
メモ: この機能はウェブワーカー内で利用可能です。
バックグラウンドフェッチ API は、動画や音声ファイル、ソフトウェアのような、時間のかかるダウンロードをうまく処理するためのメソッドを提供します。
ウェブアプリケーションがユーザーに大きなファイルをダウンロードさせる必要があるとき、よく起きる問題として、ユーザーがダウンロードの完了までページに接続し続けなければならないという問題があります。接続が切れたり、タブを閉じたり、ページを離れたりすると、ダウンロードは中止されてしまいます。
バックグラウンド同期 API を用いて、ユーザーが接続されるまでサービスワーカーに処理を延期させることができますが、この方法は大容量ファイルのダウンロードのような時間のかかる処理には使えません。バックグラウンド同期は、フェッチが完了するまでサービスワーカーが生き続ける必要がありますが、ブラウザーはバッテリーの寿命を長持ちさせるため、また、バックグラウンドで不要なタスクが発生することを防ぐために、途中でタスクを終了させてしまうでしょう。
バックグラウンドフェッチ API はこの問題を解決します。たとえば、ユーザーが動画をダウンロードするためのボタンをクリックしたときなどに、ウェブ開発者はブラウザーにバックグラウンドでフェッチを行うよう指示できるようになります。指示が行われると、ブラウザーはユーザーに見える形でフェッチを実行します。(ユーザーに進捗状況を表示し、ユーザーはダウンロードをキャンセルすることもできます。)ダウンロードが完了すると、ブラウザーはサービスワーカーを開きます。この時点で、アプリケーションは必要に応じて応答を処理できます。
バックグラウンドフェッチ API は、ユーザーがプロセスをオフラインで開始した場合にも、フェッチの発生を可能にします。一旦接続されると、処理が開始されます。ユーザーがオフラインになると、再びオンラインになるまでプロセスは一時停止します。
キーがバックグラウンドフェッチの ID で、値が BackgroundFetchRegistration のオブジェクトのマップ。
BackgroundFetchRegistrationバックグラウンドフェッチを表します。
BackgroundFetchRecord個々のフェッチ要求と応答を表します。
BackgroundFetchEventbackgroundfetchabort と backgroundfetchclick に渡されるイベント型。
BackgroundFetchUpdateUIEventbackgroundfetchsuccess と backgroundfetchfail に渡されるイベント型。
BackgroundFetchManager オブジェクトへの参照を返します。これがバックグラウンドフェッチ操作を管理します。
backgroundfetchabort イベントバックグラウンドフェッチ操作がユーザーまたはアプリによって取り消されたときに発行されます。
backgroundfetchclick イベントユーザーがバックグラウンドフェッチ操作の UI をクリックしたときに発生します。
backgroundfetchfail イベントバックグラウンドフェッチ操作内のリクエストの少なくとも 1 つが失敗した場合に発生します。
backgroundfetchsuccess イベントバックグラウンドフェッチ操作内のすべてのリクエストが成功したときに発生します。
バックグラウンドフェッチを使用する前に、ブラウザーで利用可能か確認しましょう。
バックグラウンドフェッチの使用には登録済みのサービスワーカーが必要となります。そして、 backgroundFetch.fetch() を呼び出してフェッチを実行します。これは BackgroundFetchRegistration で解決されるプロミスを返します。
バックグラウンドフェッチは、複数のファイルを取得することができます。下記の例では、フェッチは MP3 ファイルと JPEG ファイルをリクエストします。このことは、ユーザーが 1 つのアイテムとして見ている、複数ファイルで構成されたパッケージ (たとえば、 podcast とアートワーク) を一度にダウンロードすることを可能にします。
それ以外のコードや例は、バックグラウンド取得の概要のデモにあります。
| Background Fetch |
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。
より良いインターネットのための青写真。
このコンテンツの一部は、©1998–2026 個人の mozilla.org 協力者です。コンテンツはクリエイティブ・コモンズ・ライセンスのもとで利用できます。