Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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 HTMLVideoElement

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

Zdroje