BackgroundFetchRegistration: match() 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 match() Methode des BackgroundFetchRegistration Interfaces gibt das erste übereinstimmende BackgroundFetchRecord zurück.
Syntax
match(request)
match(request, options)
Parameter
request-
Der
Request, für den Sie versuchen, Aufzeichnungen zu finden. Dies kann einRequestObjekt oder eine URL sein. optionsOptional-
Ein Objekt, das Optionen für den
matchVorgang festlegt. Die verfügbaren Optionen sind:ignoreSearchOptional-
Ein boolescher Wert, der angibt, ob die Abfragezeichenfolge in der URL ignoriert werden soll. Wenn beispielsweise auf
truegesetzt, würde der Teil?value=barvonhttps://example.com/?value=barbeim Abgleichen ignoriert werden. Standard istfalse. ignoreMethodOptional-
Ein boolescher Wert. Wenn
true, verhindert es, dass Übereinstimmungsvorgänge diehttp-Methode desRequestvalidieren. Wennfalse(Standard) sind nurGETundHEADerlaubt. ignoreVaryOptional-
Ein boolescher Wert. Wenn
true, gibt an, dass derVaryHeader ignoriert werden soll. Standard istfalse.
Rückgabewert
Ein Promise, der mit dem ersten BackgroundFetchRecord aufgelöst wird, der zur Anfrage passt, oder mit undefined, falls keine Übereinstimmung gefunden wird.
Hinweis:
BackgroundFetchRegistration.match() ist im Grunde genommen identisch mit
BackgroundFetchRegistration.matchAll(), außer dass es nicht mit einem Array aller übereinstimmenden Einträge aufgelöst wird, sondern nur mit dem ersten übereinstimmenden Eintrag.
Ausnahmen
InvalidStateErrorDOMException-
Wird zurückgegeben, wenn Sie
match()aufrufen, während keine Fetches im Gange sind. Dieser Zustand wird durchBackgroundFetchRegistration.recordsAvailable, das auffalsegesetzt ist, widerspiegelt.
Beispiele
In diesem Beispiel suchen wir nach einem Eintrag mit der URL "/ep-5.mp3". Wenn ein BackgroundFetchRecord gefunden wird, können wir einige Informationen darüber zurückgeben.
bgFetch.match("/ep-5.mp3").then(async (record) => {
if (!record) {
console.log("No record found");
return;
}
console.log(`Here's the request`, record.request);
const response = await record.responseReady;
console.log(`And here's the response`, response);
});
Spezifikationen
| Specification |
|---|
| Background Fetch # background-fetch-registration-match |