CKTIS / JavaScript
HTMLMediaElement.play() — asynchronní spuštění přehrávání
Metoda play() požádá o spuštění nebo obnovení přehrávání zvuku či videa. Vrací Promise, proto by rozhraní mělo počítat jak se zahájením přehrávání, tak se zamítnutím požadavku.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
media.play() // Promise<undefined>; media is an HTMLAudioElement or HTMLVideoElementHTMLMediaElement.play() je metoda webového API prohlížeče určená pro prvky audio a video, nikoli funkce ECMAScriptu. Nepřijímá žádné argumenty. Vrací Promise, která se při zahájení přehrávání splní hodnotou undefined — ne až po skončení média.
Použijte await media.play() uvnitř try...catch. Ani návrat volání, ani paused === false nepotvrzují, že přehrávání začalo. Promise může zůstat nevyřízená, dokud se načítají data; rozhraní aktualizujte až po jejím vyřízení.
NotAllowedError znamená, že přehrávání není povoleno, například kvůli zásadám automatického přehrávání. Metodu zavolejte přímo v obsluze kliknutí, ale zamítnutí přesto ošetřete. NotSupportedError se týká nepodporovaného zdroje. Přerušení čekajícího požadavku pomocí pause() nebo opětovným načtením může způsobit AbortError.
Příklad záměrně používá text místo nahrávky, aby ukázal ošetření zamítnutí bez externího souboru. Nepředvádí úspěšné přehrávání. Toto API je součástí HTML Living Standard; Node 24 v repozitáři nedokládá jeho dostupnost v prohlížeči.
Pří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ýsledek
Rejected: NotSupportedError
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.