HTMLMediaElement : méthode load()
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.
La méthode load() de l'interface HTMLMediaElement réinitialise l'élément multimédia à son état initial et commence le processus de sélection d'une source multimédia et de chargement du média en préparation de la lecture depuis le début.
La quantité de données multimédias préchargées est déterminée par la valeur de l'attribut preload de l'élément.
Cette méthode est généralement utile uniquement lorsque vous avez apporté des modifications dynamiques à l'ensemble des sources disponibles pour l'élément multimédia, soit en modifiant l'attribut src de l'élément, soit en ajoutant ou en supprimant des éléments <source> imbriqués dans l'élément multimédia lui-même. load() réinitialisera l'élément et rescannera les sources disponibles, permettant ainsi aux modifications de prendre effet.
Syntaxe
load()
Paramètres
Aucun.
Valeur de retour
Aucune (undefined).
Notes d'utilisation
Appeler load() interrompt toutes les opérations en cours impliquant cet élément multimédia, puis commence le processus de sélection et de chargement d'une ressource multimédia appropriée en fonction des options définies dans l'élément HTML <audio> ou <video> et son attribut src ou ses éléments enfants <source>. Cela est décrit plus en détail dans la page vidéo et audio HTML.
Le processus d'interruption de toutes les activités en cours entraînera la résolution ou le rejet de toutes les promesses (Promise) en attente retournées par play(), en fonction de leur état avant le début du chargement du nouveau média. Les promesses de lecture en attente sont annulées avec une erreur DOMException "AbortError".
Des évènements appropriés seront envoyés à l'élément multimédia lui-même au fur et à mesure que le processus de chargement progresse :
- Si l'élément est déjà en train de charger un média, ce processus de chargement est annulé et l'évènement
abortest envoyé. - Si l'élément a déjà été initialisé avec un média, l'évènement
emptiedest envoyé. - Si la réinitialisation de la position de lecture au début du média modifie réellement la position de lecture (c'est-à-dire qu'elle n'était pas déjà au début), un évènement
timeupdateest envoyé. - Une fois que le média a été sélectionné et que le chargement est prêt à commencer, l'évènement
loadstartest envoyé. - À partir de ce moment, les évènements sont envoyés comme pour tout chargement de média.
Exemples
Cet exemple trouve un élément HTML <video> dans le document et le réinitialise en appelant load().
const mediaElem = document.querySelector("video");
mediaElem.load();
Spécifications
| Spécification |
|---|
| HTML # dom-media-load-dev |