FileRequest.onprogress

Non standard

Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

Résumé

Cette propriété spécifie une fonction de rappel devant être exécutée de façon répétée pendant que l'opération représentée par un objet  FileRequest est en cours.

Syntaxe

instanceOfFileRequest.onprogress = function;

Où instanceOfFileRequest est un objet FileRequest et function est la fonction JavaScript à exécuter.

Chaque fois que la fonction callback est appelée, elle obtient un objet en tant que premier paramètre. Ces objets contiennent deux propriétés :

loaded
Un nombre représentant la quantité actuelle d'octets traités par l'opération.
total
Un nombre représentant le nombre total d'octets qui seront traités par l'opération.

Exemple

// Supposons 'request' qui est un objet FileRequest

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

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

Spécification

Ne fait partie d'aucune spécification.

Voir aussi