CKTIS / HTML
onloadstart — gérer le début du chargement d’un média
L’attribut onloadstart indique le code JavaScript qui gère l’événement loadstart. Pour les éléments audio et video, cet événement signale le début de la recherche de données multimédias, et non la fin du téléchargement ni la disponibilité pour la lecture.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onloadstart="JavaScript statements"onloadstart est un attribut de contenu gestionnaire d’événement pour loadstart. Sa valeur est le corps d’une fonction JavaScript, et non une adresse de ressource. Dans le code de l’attribut, le paramètre event donne accès à l’événement. L’index HTML répertorie cet attribut comme disponible sur les éléments HTML ; sa seule présence ne signifie toutefois pas que chaque élément déclenche automatiquement loadstart.
Pour audio et video, le navigateur déclenche loadstart lorsqu’il commence à rechercher des données dans l’algorithme de sélection d’une ressource multimédia. Cela ne confirme ni le téléchargement des données, ni la réussite du chargement, ni la disponibilité de la lecture. loadedmetadata et loadeddata correspondent à d’autres étapes ; il ne faut pas non plus confondre loadstart avec load.
L’attribut HTML onloadstart et la propriété JavaScript du même nom configurent le gestionnaire. Dans addEventListener('loadstart', handler), le nom de l’événement n’a pas de préfixe on. La politique de sécurité du contenu (Content Security Policy) peut bloquer le code placé directement dans l’attribut.
L’exemple déclenche volontairement un événement loadstart synthétique : il ne nécessite donc ni fichier multimédia ni connexion réseau. Le paragraphe devrait afficher loadstart. Cela vérifie l’appel du gestionnaire, et non le comportement réel du chargement. Date de l’instantané de l’index : 2026-11-18.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>onloadstart</title>
<audio id="media" onloadstart="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
document.getElementById('media').dispatchEvent(new Event('loadstart'));
</script>Résultat
loadstart
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.