CKTIS / HTML
onsuspend — omgaan met het onderbreken van media ophalen
Het attribuut onsuspend geeft aan welke JavaScript-code wordt uitgevoerd bij de gebeurtenis suspend. Bij audio en video betekent deze gebeurtenis dat de browser opzettelijk tijdelijk geen gegevens ophaalt, niet dat het afspelen is gepauzeerd.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onsuspend="JavaScript statements"onsuspend is een globaal contentattribuut voor de gebeurtenishandler van suspend. De waarde is JavaScript-code, geen bronadres of Booleaanse waarde. Hoewel het attribuut beschikbaar is op HTML-elementen, wordt het meestal gebruikt bij de elementen audio en video.
De browser activeert suspend wanneer deze het ophalen van mediagegevens opzettelijk onderbreekt en daarbij networkState instelt op NETWORK_IDLE. De browser kan bijvoorbeeld wachten tot het afspelen begint voordat er meer gegevens worden gedownload. Dit betekent op zichzelf niet dat er een fout is of dat het afspelen is gepauzeerd: pause heeft betrekking op afspelen, terwijl stalled slaat op de situatie waarin de browser gegevens probeert op te halen maar ze niet ontvangt.
In de attribuutcode geeft event toegang tot het gebeurtenisobject. In JavaScript kunt u in plaats daarvan een functie toewijzen aan de eigenschap element.onsuspend of element.addEventListener('suspend', handler) gebruiken. De gebeurtenisnaam bevat niet het voorvoegsel on.
Het voorbeeld activeert een synthetische gebeurtenis, zodat het resultaat niet afhankelijk is van het netwerk of bufferbeslissingen van de browser. Het test alleen of de attribuutcode wordt uitgevoerd; het onderbreekt het ophalen niet en verandert networkState niet. Het beveiligingsbeleid van een pagina kan eventhandlercode blokkeren die rechtstreeks in attributen is geschreven.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsuspend demo</title>
<audio id="media" onsuspend="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
document.getElementById('media').dispatchEvent(new Event('suspend'));
</script>
</html>Resultaat
suspend
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.