BackgroundFetchRegistration: matchAll()-Methode

Syntax

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.

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

Spezifikationen

Browser-Kompatibilität