CKTIS / JavaScript
HTMLMediaElement.pause() — pauziranje reprodukcije
Metoda pause() pauzira reprodukciju audio ili video elementa bez vraćanja na početak. Ne prima argumente i vraća undefined. Stanje paused mijenja se sinkrono, dok se događaj pause šalje kasnije.
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.pause()HTMLMediaElement.pause metoda je pregledničkog Web API-ja koju nasljeđuju elementi audio i video. Pozovite media.pause() na multimedijskom elementu. Metoda ne prima argumente i vraća undefined, a ne promise. Nije dio samog ECMAScripta; prisutnost Node.js-a u projektu ne potvrđuje da je metoda ondje dostupna.
Ako je paused jednak false, metoda ga sinkrono postavlja na true. Ne vraća reprodukciju na početak. Za nastavak reprodukcije upotrijebite play(). Ponovni poziv metode pause() na već pauziranom elementu ne stvara novi događaj pause.
Kada se stanje promijeni, preglednik stavlja zadatak u red čekanja koji šalje timeupdate, a zatim pause; ti se događaji ne šalju prije nego što se metoda vrati. Nakon slanja obaju događaja zadatak uz pogrešku AbortError odbija samo one promiseove koje je vratio play() i koji su još bili na popisu promiseova reprodukcije na čekanju za taj element kada je algoritam metode pause() preuzeo popis. Promise koji je već uklonjen s popisa za zadatak u redu čekanja koji šalje događaj playing još se može ispuniti. Obradite odbijanja promiseova koje vraća play(). Ako je networkState jednak NETWORK_EMPTY, pause() pokreće i algoritam odabira resursa — nemojte ovu metodu smatrati načinom otkazivanja preuzimanja.
Primjer namjerno upotrebljava novi element bez izvora, koji na početku ima paused === true. Prikazuje povratnu vrijednost i sigurno ponavljanje poziva, ali ne prikazuje prekid aktivne reprodukcije.
Primjeri
const media = document.createElement('video');
const result = media.pause();
console.log(media.paused);
console.log(result === undefined);
media.pause();
console.log(media.paused);Rezultat
true true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.