CKTIS / JavaScript
HTMLMediaElement.play() — asynchrónne spustenie prehrávania
Metóda play() žiada o spustenie alebo obnovenie prehrávania zvuku či videa. Vráti Promise, preto by rozhranie malo počítať so začatím prehrávania aj so zamietnutím požiadavky.
Verzia: 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() je metóda webového API prehliadača určená pre prvky audio a video, nie funkcia ECMAScriptu. Neprijíma žiadne argumenty. Vráti Promise, ktorá sa pri začatí prehrávania splní hodnotou undefined — nie až po skončení média.
Použite await media.play() vnútri try...catch. Ani návrat volania, ani paused === false nepotvrdzujú, že sa prehrávanie začalo. Promise môže zostať nevybavená, kým sa načítavajú údaje; rozhranie aktualizujte po jej vybavení.
NotAllowedError znamená, že prehrávanie nie je povolené, napríklad pre pravidlá automatického prehrávania. Metódu zavolajte priamo v obsluhe kliknutia, ale zamietnutie aj tak ošetrite. NotSupportedError sa týka nepodporovaného zdroja. Prerušenie čakajúcej požiadavky pomocou pause() alebo opätovným načítaním môže spôsobiť AbortError.
Príklad zámerne používa text namiesto nahrávky, aby ukázal ošetrenie zamietnutia bez externého súboru. Nepredvádza úspešné prehrávanie. Toto API patrí do HTML Living Standard; Node 24 v repozitári nepotvrdzuje jeho dostupnosť v prehliadači.
Príklady
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;
}
});Výsledok
Rejected: NotSupportedError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.