HTMLMediaElement : mthode load()

Syntaxe

load()

Paramtres

Aucun.

Valeur de retour

Aucune (undefined).

Notes d'utilisation

Appeler load() interrompt toutes les oprations en cours impliquant cet lment multimdia, puis commence le processus de slection et de chargement d'une ressource multimdia approprie en fonction des options dfinies dans l'lment HTML <audio> ou <video> et son attribut src ou ses lments enfants <source>. Cela est dcrit plus en dtail dans la page vido et audio HTML.

Le processus d'interruption de toutes les activits en cours entranera la rsolution ou le rejet de toutes les promesses (Promise) en attente retournes par play(), en fonction de leur tat avant le dbut du chargement du nouveau mdia. Les promesses de lecture en attente sont annules avec une erreur DOMException "AbortError".

Des vnements appropris seront envoys l'lment multimdia lui-mme au fur et mesure que le processus de chargement progresse :

• Si l'lment est dj en train de charger un mdia, ce processus de chargement est annul et l'vnement abort est envoy.
• Si l'lment a dj t initialis avec un mdia, l'vnement emptied est envoy.
• Si la rinitialisation de la position de lecture au dbut du mdia modifie rellement la position de lecture (c'est--dire qu'elle n'tait pas dj au dbut), un vnement timeupdate est envoy.
• Une fois que le mdia a t slectionn et que le chargement est prt commencer, l'vnement loadstart est envoy.
• partir de ce moment, les vnements sont envoys comme pour tout chargement de mdia.

Exemples

Cet exemple trouve un lment HTML <video> dans le document et le rinitialise en appelant load().

const mediaElem = document.querySelector("video");
mediaElem.load();

Spcifications

Compatibilit des navigateurs