BackgroundFetchRegistration.matchAll()
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Want more browser support for this feature? Tell us why.
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
BackgroundFetchRegistration インターフェイスの matchAll() メソッドは、マッチする BackgroundFetchRecord オブジェクトの配列を返します。
構文
js
matchAll(request)
matchAll(request,options)
引数
requestoptions省略可-
match操作のオプションを指定するオブジェクトです。以下が利用可能です。ignoreSearch-
URL 中のクエリー文字列を無視するかどうか指定するbool 値です。例えば
trueのとき、http://foo.com/?value=barの?value=bar部分はマッチ処理で無視されます。デフォルトはfalseです。 ignoreMethod-
bool 値です。
trueのとき、マッチ処理はRequestのhttpメソッドを検証しません。false(デフォルト値)の場合、GETとHEADのみ許可されます。 ignoreVary-
bool 値です。
trueはVARYヘッダーを無視することを意味します。デフォルトはfalseです。
返値
マッチした全ての BackgroundFetchRecord オブジェクトの配列で解決される Promise を返します。
例外
InvalidStateErrorDOMException-
recordsAvailableフラグがfalseのとき、発生します。 これは、進行中のフェッチが存在しないことを意味します。
例
matchAll() を引数なしで呼び出すことで、バックグラウンドフェッチの全ての record を取得することができます。
js
const records = await bgFetch.matchAll();
console.log(records); // BackgroundFetchRecord オブジェクトの配列
仕様書
| 仕様書 |
|---|
| Background Fetch # background-fetch-registration-match-all |