Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLMediaElement.play() — asinhroni zagon predvajanja

Metoda play() zahteva začetek ali nadaljevanje predvajanja zvoka ali videa. Vrne Promise, zato mora vmesnik upoštevati tako začetek predvajanja kot zavrnitev zahteve.

Različica: 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 HTMLVideoElement

HTMLMediaElement.play() je metoda brskalniškega spletnega API-ja za elemente audio in video, ne funkcija ECMAScript. Ne sprejema argumentov. Vrne Promise, ki se izpolni z vrednostjo undefined, ko se predvajanje začne — ne šele, ko se medij konča.

Uporabite await media.play() znotraj try...catch. Niti vrnitev klica niti paused === false ne potrjujeta, da se je predvajanje začelo. Promise lahko ostane nerešena, medtem ko se nalagajo podatki; vmesnik posodobite, ko se promise razreši.

NotAllowedError pomeni, da predvajanje ni dovoljeno, na primer zaradi pravil samodejnega predvajanja. Metodo pokličite neposredno v obravnavalniku klika, vendar vseeno obravnavajte zavrnitev. NotSupportedError se nanaša na nepodprt vir. Prekinitev čakajoče zahteve z pause() ali ponovnim nalaganjem lahko povzroči AbortError.

Primer namenoma uporabi besedilo namesto posnetka, da prikaže obravnavo zavrnitve brez zunanje datoteke. Ne prikazuje uspešnega predvajanja. Ta API je del HTML Living Standard; Node 24 v repozitoriju ne dokazuje, da je API na voljo v brskalniku.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri