CKTIS / HTML
onstalled — vastgelopen mediadownloads afhandelen
Het attribuut onstalled bepaalt welke code wordt uitgevoerd bij de gebeurtenis stalled, wanneer de browser mediagegevens probeert op te halen maar er geen gegevens binnenkomen. Dit gaat over downloaden, niet noodzakelijk over een onderbreking van het afspelen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
HTML: onstalled="JavaScript statements"
JavaScript: media.onstalled = handler;
Alternative: media.addEventListener("stalled", handler);onstalled is een contentattribuut voor een gebeurtenishandler van stalled. Het is beschikbaar als globaal HTML-attribuut, maar de browser verstuurt deze gebeurtenis van nature naar de media-elementen audio en video. De waarde bevat JavaScript-instructies, geen resourceadres of Booleaanse waarde.
De gebeurtenis treedt op wanneer een element actief mediagegevens probeert op te halen, maar gedurende de door het detectiemechanisme bepaalde time-out voor vastgelopen media geen gegevens ontvangt. Dit betekent niet automatisch dat er een fout is of dat het afspelen is onderbroken: gegevens in de buffer kunnen ervoor zorgen dat het afspelen doorgaat. waiting gaat over afspelen dat op gegevens wacht, terwijl suspend aangeeft dat de browser het ophalen heeft opgeschort.
Gebruik in HTML onstalled="..."; wijs in JavaScript een functie toe aan media.onstalled. Die toewijzing vervangt de vorige handler op die plek. Het alternatief media.addEventListener("stalled", handler) registreert onafhankelijke listeners. Voeg geen niet-vertrouwde tekst toe aan attribuutcode; Content Security Policy kan inline-handlers blokkeren.
Het voorbeeld verstuurt een synthetische gebeurtenis om de koppeling van het attribuut deterministisch te controleren. Het downloadt geen bestand en simuleert niet de werkelijke netwerk- of bufferstatus. De verwachte tekst in de alinea is stalled.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onstalled demonstration</title>
<audio id="media" onstalled="document.getElementById('status').textContent = event.type"></audio>
<p id="status">pending</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('stalled'));
</script>
</html>Resultaat
stalled
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.