BackgroundFetchRegistration: matchAll()-Methode

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die matchAll()-Methode des BackgroundFetchRegistration-Interfaces gibt ein Array von passenden BackgroundFetchRecord-Objekten zurück.

Syntax

js
matchAll()
matchAll(request)
matchAll(request,options)

Parameter

request Optional

Der Request, für den Sie versuchen, Datensätze zu finden. Dies kann ein Request-Objekt oder eine URL sein. Wenn dieser Parameter weggelassen wird, werden alle Datensätze in das Ergebnis einbezogen.

options Optional

Ein Objekt, das Optionen für den match-Vorgang festlegt. Die verfügbaren Optionen sind:

ignoreSearch Optional

Ein boolescher Wert, der angibt, ob der Abfrage-String in der URL ignoriert werden soll. Wenn zum Beispiel auf true gesetzt, wird der ?value=bar-Teil von http://foo.com/?value=bar bei der Durchführung eines Abgleichs ignoriert. Standardmäßig ist dieser false.

ignoreMethod Optional

Ein boolescher Wert. Wenn true, verhindert, dass Abgleichsvorgänge die http-Methode des Request validieren. Wenn false (der Standard), sind nur GET und HEAD erlaubt.

ignoreVary Optional

Ein boolescher Wert. Wenn true, zeigt an, dass der Vary-Header ignoriert werden sollte. Standardmäßig ist dieser false.

Rückgabewert

Ein Promise, der mit einem Array aller passenden BackgroundFetchRecord-Objekte aufgelöst wird.

Ausnahmen

InvalidStateError DOMException

Wird zurückgegeben, wenn das recordsAvailable-Flag false ist, was anzeigt, dass kein Abruf im Gange ist.

Beispiele

Verwenden Sie matchAll() ohne Parameter, um alle Datensätze in einem Hintergrundabruf zurückzugeben.

js
const records = await bgFetch.matchAll();
console.log(records); // an array of BackgroundFetchRecord objects

Spezifikationen

Specification
Background Fetch
# background-fetch-registration-match-all

Browser-Kompatibilität