CKTIS / JavaScript
HTMLMediaElement.play() — asynchroon afspelen starten
De methode play() vraagt om audio- of videoafspelen te starten of te hervatten. De methode retourneert een Promise. De interface moet daarom rekening houden met zowel het starten van het afspelen als het afwijzen van het verzoek.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
media.play() // Promise<undefined>; media is an HTMLAudioElement or HTMLVideoElementHTMLMediaElement.play() is een browser-Web-API-methode voor audio- en video-elementen, geen ECMAScript-functie. De methode heeft geen argumenten. Ze retourneert een Promise die wordt vervuld met de waarde undefined zodra het afspelen begint — niet pas wanneer de media zijn afgelopen.
Gebruik await media.play() binnen try...catch. Noch het terugkeren van de aanroep, noch paused === false bevestigt dat het afspelen is begonnen. De promise kan in behandeling blijven terwijl gegevens worden geladen; werk de interface bij nadat de promise is afgehandeld.
NotAllowedError betekent dat afspelen niet is toegestaan, bijvoorbeeld vanwege het autoplaybeleid. Roep de methode rechtstreeks aan in een klikhandler, maar handel een afwijzing nog steeds af. NotSupportedError heeft betrekking op een niet-ondersteunde bron. Een aanroep die nog in behandeling is onderbreken met pause() of door opnieuw te laden kan AbortError veroorzaken.
Het voorbeeld gebruikt bewust tekst in plaats van een opname om te laten zien hoe je een afwijzing afhandelt zonder extern bestand. Het toont geen geslaagde weergave. Deze API hoort bij de HTML Living Standard; Node 24 in een repository toont niet aan dat de API in een browser beschikbaar is.
Voorbeelden
const media = document.createElement('audio');
media.src = 'data:text/plain,not-media';
const button = document.createElement('button');
button.textContent = 'Test play()';
const status = document.createElement('pre');
document.body.append(button, status);
button.addEventListener('click', async () => {
button.disabled = true;
try {
await media.play();
status.textContent = 'Playback started';
} catch (error) {
status.textContent = `Rejected: ${error.name}`;
} finally {
button.disabled = false;
}
});Resultaat
Rejected: NotSupportedError
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.