TimeRanges
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Lors du chargement d'une ressource média pour une utilisation avec un élément HTML <audio> ou <video>, l'interface TimeRanges est utilisée pour représenter les plages de temps de la ressource média qui ont été mises en mémoire tampon, les plages de temps qui ont été lues et les plages de temps qui sont accessibles par recherche.
Un objet TimeRanges comprend une ou plusieurs plages de temps, chacune définie par une position de début et de fin. On récupère ces valeurs en utilisant les méthodes start() et end(), en passant en paramètre l'index de la plage de temps que l'on souhaite récupérer.
Objets TimeRanges normalisés
Plusieurs membres des objets HTMLMediaElement retournent un objet TimeRanges normalisé — que la spécification décrit (angl.) comme ayant les caractéristiques suivantes :
Les plages dans un tel objet sont ordonnées, ne se chevauchent pas et ne se touchent pas (les plages adjacentes sont fusionnées en une seule plage plus grande). Une plage peut être vide (référant à un seul instant dans le temps).
Propriétés d'instance
TimeRanges.lengthLecture seule-
Retourne un
unsigned longreprésentant le nombre de plages de temps représentées par l'objet TimeRanges.
Méthodes d'instance
TimeRanges.start()-
Retourne le temps pour le début de la plage avec l'index défini.
TimeRanges.end()-
Retourne le temps pour la fin de la plage avec l'index défini.
Spécifications
| Spécification |
|---|
| HTML # time-ranges |