FileRequest.onprogress

Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Summary

This property specifies a callback function to be run repeatedly while the operation represented by a FileRequest object is in progress.

Syntax

JavaScript
instanceOfFileRequest.onprogress = function;

Where instanceOfFileRequest is a FileRequest object and function is the JavaScript function to execute.

Each time the function callback is called, it gets an object as its first parameter. Those objects contain two properties:

loaded
A number representing the current amount of bytes processed by the operation.
total
A number representing the total amount of bytes that will be processed by the operation.

Example

JavaScript
// Assuming 'request' which is a FileRequest object

request.onprogress = function (status) {
  var progress = document.querySelector('progress');

  progress.value = status.loaded;
  progress.max   = status.total;
}

Specification

Not part of any current specification.

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/filerequest/onprogress

API DOM Files Property Reference Référence