The character encoding was not declared. Proceeding using “windows-1252”.
Pagina nu spune cu ce codificare a fost salvată, așa că browserul ghicește, de obicei windows-1252. Diacriticele salvate în UTF-8 apar atunci ca „ă”, „Č›” sau „ÅŸ”. Pune <meta charset="utf-8"> ca primul element din <head> și salvează fișierul în UTF-8.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un fișier text este doar o serie de octeți; ca să-i transforme în litere, browserul trebuie să știe codificarea. Mesajul spune că nici serverul (antetul Content-Type), nici pagina (<meta charset>) nu au declarat-o, așa că validatorul a presupus windows-1252, codificarea occidentală veche.
Literele englezești arată la fel în ambele codificări, deci problema se vede doar la caracterele speciale. Litera ă, salvată în UTF-8, ocupă doi octeți; citiți ca windows-1252, devin două caractere ciudate: „Ä” și „ƒ”. De aici textele de tipul „Prăjitură”.
Reparația are două părți: declari <meta charset="utf-8"> cât mai sus în <head> (trebuie să fie în primii 1024 de octeți ai fișierului) și te asiguri că fișierul chiar este salvat în UTF-8. În VS Code, codificarea apare în bara de jos, în dreapta (de exemplu „UTF-8”).
De ce apare: cauzele frecvente
1Lipsește meta charset din head
<head>
<title>Cafenea</title>
</head><head>
<meta charset="utf-8">
<title>Cafenea</title>
</head>Fără declarație, browserul ghicește codificarea. meta charset pus primul în head elimină ghicitul.
2meta charset pus prea jos în head
<head>
<title>Cafenea</title>
<style>
/* 2000 de rânduri de CSS */
</style>
<meta charset="utf-8">
</head><head>
<meta charset="utf-8">
<title>Cafenea</title>
<style>
/* CSS */
</style>
</head>Declarația trebuie să apară în primii 1024 de octeți. După un bloc mare de CSS, browserul a decis deja codificarea.
3Fișierul este salvat în altă codificare
<!-- fișier salvat ca Windows 1250 sau ANSI -->
<meta charset="utf-8">
<p>Prăjitură</p><!-- fișier salvat ca UTF-8: VS Code, bara de jos, Save with Encoding -->
<meta charset="utf-8">
<p>Prăjitură</p>Declarația trebuie să spună adevărul. Dacă fișierul e salvat în ANSI, chiar și cu utf-8 declarat diacriticele apar ca semne de întrebare sau romburi.
Repară eroarea, direct în pagină
Validatorul spune „The character encoding was not declared”, iar pe unele calculatoare diacriticele din pagină apar ca „ă”. Adaugă în <head>, ca prim element, declarația de codificare UTF-8, fără să schimbi restul paginii.
<!DOCTYPE html>
<html lang="ro">
<head>
<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;
}
</style>
</head>
<body>
<h1>Cafeneaua din centru</h1>
<p>Prăjitură de casă și ciocolată caldă.</p>
</body>
</html>Indiciu
Este un element meta cu un singur atribut.
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;
}
</style>
</head>
<body>
<h1>Cafeneaua din centru</h1>
<p>Prăjitură de casă și ciocolată caldă.</p>
</body>
</html>De ce merge
Fără meta charset, browserul nu știe cum să transforme octeții fișierului în litere și ghicește. Pentru ă, ș și ț, ghicitul greșit produce caractere ciudate.
<meta charset="utf-8"> pus primul în head îi spune din primii octeți că fișierul folosește UTF-8, codificarea care conține toate literele românești. Validatorul nu mai raportează eroarea, iar diacriticele se văd corect peste tot.
Alte forme ale mesajului
A “charset” attribute on a “meta” element found after the first 1024 bytes.The character encoding of the HTML document was not declared. The document will render with garbled text in some browser configurations if the document contains characters from outside the US-ASCII range.
Cum o eviți pe viitor
- Scrie
<meta charset="utf-8">ca prima linie din<head>în orice fișier HTML (scheletul Emmet din VS Code o pune automat). - Setează în editor UTF-8 ca codificare implicită și verifică bara de jos când deschizi fișiere vechi.
- Dacă un server trimite alt
charsetîn antetulContent-Type, acela are prioritate: verifică în DevTools → Network → Headers.
Întrebări frecvente
Scriu utf-8 sau UTF-8?
E la fel: valoarea nu ține cont de majuscule. Forma <meta charset="utf-8"> este cea mai folosită.
Ce înseamnă „Äƒ” sau „È›” în pagina mea?
Sunt diacritice salvate în UTF-8, dar citite cu altă codificare. Adaugă meta charset și verifică codificarea fișierului: textul își revine fără să rescrii nimic.
Erori înrudite
Start tag seen without seeing a doctype first. Expected “<!DOCTYPE html>”. Fișierul HTML nu începe cu <!DOCTYPE html>. Fără el, browserul afișează pagina în „quirks mode”, un mod de compatibilitate cu site-urile din anii 90, în care unele reguli CSS se calculează altfel. Pune <!DOCTYPE html> pe prima linie a fișierului. Element “head” is missing a required instance of child element “title”. Orice document HTML trebuie să aibă în head un element title, cu text. Adaugă <title>Numele paginii</title> după meta charset. Titlul apare pe tab-ul browserului și în rezultatele Google. Consider adding a “lang” attribute to the “html” start tag to declare the language of this document. Este un avertisment, nu o eroare: documentul nu spune în ce limbă e scris. Adaugă lang="ro" pe elementul html (<html lang="ro">), ca cititoarele de ecran să pronunțe corect textul și browserul să știe ce limbă e. Î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.
