CKTIS / JavaScript
HTMLMediaElement.pause() — wstrzymywanie odtwarzania
Metoda pause() wstrzymuje odtwarzanie elementu audio lub video bez przewijania do początku. Nie przyjmuje argumentów i zwraca undefined. Stan paused zmienia się synchronicznie, natomiast zdarzenie pause jest wysyłane później.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
media.pause()HTMLMediaElement.pause to metoda przeglądarkowego Web API, dziedziczona przez elementy audio i video. Wywołaj media.pause() na elemencie multimedialnym. Metoda nie przyjmuje argumentów i zwraca undefined, a nie obietnicę. Nie jest funkcją samego ECMAScript; obecność Node.js w projekcie nie potwierdza jej dostępności.
Jeśli paused ma wartość false, metoda ustawia ją synchronicznie na true. Nie przewija odtwarzania do początku. Aby wznowić odtwarzanie, użyj play(). Ponowne wywołanie pause() na już wstrzymanym elemencie nie generuje kolejnego zdarzenia pause.
Przy zmianie stanu przeglądarka kolejkuje zadanie wysyłające kolejno timeupdate i pause; zdarzenia nie są wysyłane przed powrotem z metody. Po wysłaniu obu zdarzeń zadanie odrzuca błędem AbortError tylko te obietnice zwrócone przez play(), które nadal znajdowały się na liście oczekujących obietnic odtwarzania elementu w chwili, gdy algorytm pause() przejął tę listę. Obietnica pobrana wcześniej z tej listy na potrzeby zakolejkowanego zadania wysyłającego zdarzenie playing nadal może zostać spełniona. Obsługuj odrzucenia obietnic zwracanych przez play(). Jeśli networkState wynosi NETWORK_EMPTY, pause() uruchamia również algorytm wyboru zasobu — nie traktuj tej metody jako mechanizmu anulowania pobierania.
Przykład celowo używa nowego elementu bez źródła, który od początku ma paused === true. Pokazuje wartość zwracaną i bezpieczne powtarzanie wywołania, ale nie demonstruje przerwania aktywnego odtwarzania.
Przykłady
const media = document.createElement('video');
const result = media.pause();
console.log(media.paused);
console.log(result === undefined);
media.pause();
console.log(media.paused);Wynik
true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.