Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 HTMLVideoElement

HTMLMediaElement.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.

Zdroje