BackgroundFetchRegistration: matchAll()-Methode

Syntax

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

Parameter

request Optional

Das Request-Objekt, für das Sie versuchen, Datensätze zu finden. Dies kann ein Request-Objekt oder eine URL sein. Wenn dieser Parameter weggelassen wird, sind alle Datensätze im Ergebnis enthalten.

options Optional

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

ignoreSearch Optional

Ein boolescher Wert, der angibt, ob die Abfragezeichenfolge in der URL ignoriert werden soll. Beispielsweise würde bei true der Teil ?value=bar von https://example.com/?value=bar beim Ausführen einer Übereinstimmung ignoriert. Standardmäßig ist es false.

ignoreMethod Optional

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

ignoreVary Optional

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

Rückgabewert

Ein Promise, das mit einem Array aller passenden BackgroundFetchRecord-Objekten auflöst.

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 Hintergrund-Abruf zurückzugeben.

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

Spezifikationen

Browser-Kompatibilität