CKTIS / JavaScript
HTMLMediaElement.play() — asinkrono pokretanje reprodukcije
Metoda play() traži pokretanje ili nastavak reprodukcije zvuka ili videa. Vraća Promise, pa sučelje treba uzeti u obzir i početak reprodukcije i odbijanje zahtjeva.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
media.play() // Promise<undefined>; media is an HTMLAudioElement or HTMLVideoElementHTMLMediaElement.play() metoda je pregledničkog Web API-ja za elemente audio i video, a ne funkcija ECMAScripta. Ne prima argumente. Vraća Promise koja se ispunjava vrijednošću undefined kada reprodukcija započne — ne tek kada medijski sadržaj završi.
Upotrijebite await media.play() unutar try...catch. Ni povratak poziva ni paused === false ne potvrđuju da je reprodukcija započela. Promise može ostati neriješena dok se podaci učitavaju; ažurirajte sučelje nakon što se razriješi.
NotAllowedError znači da reprodukcija nije dopuštena, primjerice zbog pravila automatske reprodukcije. Pozovite metodu izravno u obrađivaču klika, ali ipak obradite odbijanje. NotSupportedError odnosi se na nepodržani izvor. Prekid zahtjeva na čekanju pomoću pause() ili ponovnim učitavanjem može uzrokovati AbortError.
Primjer namjerno koristi tekst umjesto snimke kako bi prikazao obradu odbijanja bez vanjske datoteke. Ne prikazuje uspješnu reprodukciju. Ovaj API dio je HTML Living Standard; Node 24 u repozitoriju ne dokazuje dostupnost u pregledniku.
Primjeri
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;
}
});Rezultat
Rejected: NotSupportedError
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.