Background Fetch API
The progress event of the BackgroundFetchRegistration interface thrown when the associated background fetch progresses.
Practically, this event is fired when any of the following properties will return a new value:
- BackgroundFetchRegistration.uploaded,
- BackgroundFetchRegistration.downloaded,
- BackgroundFetchRegistration.result, or
- BackgroundFetchRegistration.failureReason.
Syntax
Use the event name in EventTarget/addEventListener:
addEventListener("progress", (event) => { })
Alternatively, assign to the event handler property of the interface:
onprogress = (event) => { }
Event type
A generic Event with no added properties.
Example
The following example demonstrates how to log the progress of a download. The code first checks that a downloadTotal was provided when the background fetch was registered. This is then used to calculate the percentage, based on the downloaded property.
bgFetch.addEventListener("progress", () => {
if (!bgFetch.downloadTotal) return;
const percent = Math.round(
(bgFetch.downloaded / bgFetch.downloadTotal) * 100,
);
console.log(`Download progress: ${percent}%`);
});
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
