Uncaught (in promise) DOMException: play() failed because the user didn't interact with the document first. https://goo.gl/xX8pDD
Browserele nu pornesc singure un video sau un sunet cu volum până când vizitatorul nu interacționează cu pagina. Atributul autoplay (sau play() din JavaScript) e ignorat. Pentru video de fundal, adaugă muted (și playsinline pentru iPhone); pentru sunet, pornește-l abia la un click.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Politica de autoplay din Chrome, Safari și Firefox spune: un media cu sunet poate porni automat doar după ce utilizatorul a făcut ceva pe pagină (click, tastă, atingere) sau dacă site-ul are un scor mare de implicare. Un video fără sunet (muted) poate porni oricând.
Cu atributul autoplay, browserul pur și simplu nu pornește video-ul și nu afișează nimic în consolă. Mesajul apare când pornești din JavaScript cu video.play() sau audio.play(): metoda întoarce o promisiune, iar aceasta este respinsă cu NotAllowedError. Fiindcă nu tratezi respingerea, apare „Uncaught (in promise)”.
Pe iPhone, video-ul mai are nevoie de playsinline, altfel ar încerca să intre pe ecran complet. Atributele corecte pentru un video de fundal sunt: autoplay muted loop playsinline.
De ce apare: cauzele frecvente
1Video de fundal fără muted
<video src="espresso.mp4" autoplay loop></video><video src="espresso.mp4" autoplay muted loop playsinline></video>Fără sunet, autoplay este permis. playsinline îl ține în pagină pe iPhone.
2Muzică pornită la încărcarea paginii
const muzica = new Audio("fundal.mp3");
muzica.play();const muzica = new Audio("fundal.mp3");
buton.addEventListener("click", () => {
muzica.play();
});Sunetul poate porni doar după o interacțiune. Legat de click, play() reușește.
3Promisiunea lui play() netratată
video.play();video.play().catch(() => {
butonPlay.hidden = false;
});Dacă browserul refuză, prinzi eroarea și afișezi un buton de redare, în loc de o eroare necaptată.
Repară eroarea, direct în pagină
Video-ul de fundal are autoplay loop, dar nu pornește singur, iar când încerci din JavaScript apare „play() failed because the user didn't interact with the document first”. Adaugă atributele care permit pornirea automată a unui video decorativ: fără sunet și redat în pagină pe telefon.
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Cafenea</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
.fundal-video {
width: 100%;
max-height: 360px;
object-fit: cover;
}
</style>
</head>
<body>
<video class="fundal-video" src="video/espresso.mp4" autoplay loop></video>
<h1>Cafea proaspătă, în fiecare dimineață</h1>
</body>
</html>Indiciu
Browserele permit autoplay doar pentru media fără sunet; iPhone-ul mai cere un atribut pentru redarea în pagină.
Reparația
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Cafenea</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
.fundal-video {
width: 100%;
max-height: 360px;
object-fit: cover;
}
</style>
</head>
<body>
<video class="fundal-video" src="video/espresso.mp4" autoplay muted loop playsinline></video>
<h1>Cafea proaspătă, în fiecare dimineață</h1>
</body>
</html>De ce merge
Politica de autoplay a browserelor blochează orice media cu sunet până la prima interacțiune a vizitatorului. Un video de fundal nu are nevoie de sunet, iar cu muted intră în categoria permisă: pornește imediat.
playsinline rezolvă a doua problemă, de pe iPhone, unde fără el video-ul ar încerca să se deschidă pe ecran complet în loc să ruleze în pagină.
Alte forme ale mesajului
NotAllowedError: play() failed because the user didn't interact with the document first.NotAllowedError: The request is not allowed by the user agent or the platform in the current context, possibly because the user denied permission.Autoplay is only allowed when approved by the user, the site is activated by the user, or media is muted.
Cum o eviți pe viitor
- Pentru video decorativ, scrie mereu
autoplay muted loop playsinline. - Nu porni sunet fără o acțiune a utilizatorului; oferă un buton de redare.
- Tratează mereu promisiunea întoarsă de
play()cu.catch()sautry/await. - Adaugă un
poster, ca pagina să arate bine și dacă video-ul nu pornește.
Întrebări frecvente
Pe calculatorul meu pornește, la alții nu. De ce?
Chrome ține un scor de implicare pentru fiecare site (Media Engagement Index). Pe un site pe care îl folosești des, autoplay-ul cu sunet poate fi permis; pentru un vizitator nou, nu.
Pot porni sunetul după ce video-ul a început mut?
Da, dar doar ca răspuns la o acțiune a utilizatorului, de exemplu un buton „Pornește sunetul” care face video.muted = false.
Erori înrudite
Mixed Content: The page at 'https://magazin-exemplu.ro/' was loaded over HTTPS, but requested an insecure image 'http://magazin-exemplu.ro/img/banner-toamna.jpg'. This content should also be served over HTTPS. Pagina se încarcă prin HTTPS, dar cere o resursă prin HTTP simplu (o imagine, un script, un CSS). Browserul o actualizează automat la https sau o blochează, iar lacătul din bara de adrese poate dispărea. Schimbă adresa în https:// sau folosește o cale relativă. Butonul din formular trimite formularul și reîncarcă pagina (type="submit" implicit) Un <button> fără atributul type, aflat într-un form, este implicit type="submit": la click trimite formularul și pagina se reîncarcă. Pentru butoanele care fac doar o acțiune pe pagină (arată parola, adaugă un rând), pune type="button". background-image nu apare (elementul gol nu are înălțime sau calea url() este greșită) Imaginea de fundal se desenează doar în suprafața elementului. Un div gol are înălțimea 0, deci nu se vede nimic. Dă-i o înălțime (height, min-height sau aspect-ratio). Dacă tot nu apare, verifică în Network calea din url(): e relativă la fișierul CSS, nu la pagină. Învață HTML și CSS de la zero, cu exerciții la fiecare lecție
Curs HTML & CSS: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
