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 im Ergebnis enthalten.

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 die Abfragezeichenfolge in der URL ignoriert werden soll. Wenn zum Beispiel true gesetzt ist, wird der ?value=bar Teil von http://foo.com/?value=bar beim Durchführen eines Abgleichs ignoriert. Der Standardwert ist false.

ignoreMethod Optional

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

ignoreVary Optional

Ein boolescher Wert. Wenn true, wird angezeigt, dass der Vary Header ignoriert werden sollte. Der Standardwert ist false.

Rückgabewert

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

Ausnahmen

InvalidStateError DOMException

Wird zurückgegeben, wenn das recordsAvailable Flag false ist, was darauf hinweist, 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

BCD tables only load in the browser