BackgroundFetchRegistration: progress event

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("Background Fetch API")}}{{SeeCompatTable}}{{AvailableInWorkers}}

The **progress** event of the {{domxref("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:

  • {{domxref("BackgroundFetchRegistration.uploaded", "uploaded")}},
  • {{domxref("BackgroundFetchRegistration.downloaded", "downloaded")}},
  • {{domxref("BackgroundFetchRegistration.result", "result")}}, or
  • {{domxref("BackgroundFetchRegistration.failureReason", "failureReason")}}.

Syntax

Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:

js-nolint
addEventListener("progress", (event) => { })

Alternatively, assign to the event handler property of the interface:

js-nolint
onprogress = (event) => { }

Event type

A generic {{domxref("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.

js
bgFetch.addEventListener("progress", () => {
  if (!bgFetch.downloadTotal) return;
  const percent = Math.round(
    (bgFetch.downloaded / bgFetch.downloadTotal) * 100,
  );
  console.log(`Download progress: ${percent}%`);
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}