HTMLMediaElement : évènement abort
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.
L'évènement abort se déclenche lorsque le chargement d'une ressource média est arrêté avant son achèvement, mais pas à la suite d'une erreur.
Cela se produit généralement en supprimant l'attribut src ou en le définissant sur une chaîne de caractères vide (""), puis en appelant load().
Cet évènement n'est pas annulable et ne se propage pas.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.
addEventListener("abort", (event) => { })
onabort = (event) => { }
Type d'évènement
Un objet Event générique.
Exemples
Abandonner le chargement d'une ressource média
L'exemple suivant montre comment abandonner le chargement d'une vidéo.
Lorsque vous appuyez sur le bouton, le chargement d'une ressource vidéo commence.
Après un court délai, le chargement est abandonné en supprimant l'attribut src et en appelant la méthode load().
Si la ressource vidéo est toujours en cours de chargement lorsque load() est appelée, l'évènement abort se déclenche.
HTML
<video controls width="250"></video>
<button id="loadAndAbort">Charger et abandonner la vidéo</button>
<pre id="log"></pre>
CSS
video,
button,
pre {
display: block;
margin-block: 1rem;
}
JavaScript
const video = document.querySelector("video");
const loadAndAbortButton = document.querySelector("#loadAndAbort");
const log = document.querySelector("#log");
video.addEventListener("abort", () => {
log.textContent += "Chargement de la vidéo abandonné\n";
});
loadAndAbortButton.addEventListener("click", () => {
log.textContent = "Chargement de la vidéo...\n";
video.src = `/shared-assets/videos/flower.webm?nocache=${Date.now()}`;
video.load();
setTimeout(() => {
video.removeAttribute("src");
video.load();
}, 50);
});
Résultat
Spécifications
| Spécification |
|---|
| HTML # event-media-abort |
| HTML # handler-onabort |
Compatibilité des navigateurs
Voir aussi
- L'interface
HTMLAudioElement - L'interface
HTMLVideoElement - L'élément HTML
<audio> - L'élément HTML
<video>