...
Eroare HTML și CSS · Imagini de fundal, video, iframe și CDN

Uncaught (in promise) DOMException: play() failed because the user didn't interact with the document first. https://goo.gl/xX8pDD

Pe scurt

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

Greșit
HTML
<video src="espresso.mp4" autoplay loop></video>
Corect
HTML
<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

Greșit
HTML
const muzica = new Audio("fundal.mp3");
muzica.play();
Corect
HTML
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ă

Greșit
HTML
video.play();
Corect
HTML
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ă tu

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.

Codul care dă eroarea
HTML
<!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ă.

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() sau try/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

← Toate erorile HTML și CSS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.