BackgroundFetchRegistration: progress-Ereignis
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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.
Das progress-Ereignis der BackgroundFetchRegistration-Schnittstelle wird ausgelöst, wenn der zugehörige Hintergrundabruf fortschreitet.
In der Praxis wird dieses Ereignis ausgelöst, wenn eine der folgenden Eigenschaften einen neuen Wert zurückgibt:
uploaded,downloaded,resultoderfailureReason.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("progress", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onprogress = (event) => { }
Ereignistyp
Ein generisches Event ohne zusätzliche Eigenschaften.
Beispiel
Das folgende Beispiel zeigt, wie Sie den Fortschritt eines Downloads protokollieren. Der Code prüft zunächst, ob bei der Registrierung des Hintergrundabrufs ein downloadTotal angegeben wurde. Dieser Wert wird dann verwendet, um anhand der Eigenschaft downloaded den Prozentsatz zu berechnen.
bgFetch.addEventListener("progress", () => {
if (!bgFetch.downloadTotal) return;
const percent = Math.round(
(bgFetch.downloaded / bgFetch.downloadTotal) * 100,
);
console.log(`Download progress: ${percent}%`);
});
Spezifikationen
| Spezifikation |
|---|
| Background Fetch # background-fetch-registration-events |