error TS7017: Element implicitly has an 'any' type because type 'typeof globalThis' has no index signature.
Citești sau scrii o variabilă globală (globalThis.config, this.x la nivel de fișier) pe care TypeScript nu o cunoaște. Declar-o: declare var config: Config; într-un script sau în declare global { } într-un modul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
globalThis e obiectul global (în browser window, în Node global). Tipul lui, typeof globalThis, conține doar ce a fost declarat: funcțiile din biblioteca standard, variabilele var și funcțiile tale de la nivel de script, plus declarațiile declare global. Nu are un index signature pentru orice nume.
Când scrii globalThis.configurare = {...} sau citești globalThis.configurare, iar configurare nu e declarat nicăieri, TypeScript nu găsește proprietatea și ar da any. În modul strict raportează TS7017.
Cazuri frecvente: variabile globale puse de un script extern sau de o bibliotecă, valori de configurare partajate, this.x la nivelul fișierului (unde this e chiar obiectul global, vezi TS7041). Reparația e să declari variabila globală cu tipul ei, ca TypeScript să o cunoască.
De ce apare: cauzele frecvente
1Variabilă globală nedeclarată, într-un script
globalThis.configurare = { tema: 'dark' };declare var configurare: { tema: string };
globalThis.configurare = { tema: 'dark' };declare var la nivelul unui script adaugă proprietatea în tipul obiectului global.
2Variabilă globală nedeclarată, într-un modul
export {};
globalThis.versiune = '1.0';export {};
declare global {
var versiune: string;
}
globalThis.versiune = '1.0';Într-un modul, declarațiile sunt locale. declare global extinde explicit tipul global.
3this la nivelul fișierului
const f = () => this.total;const stare = { total: 0 };
const f = () => stare.total;La nivel de script, this e obiectul global, deci this.total caută pe globalThis. Folosește un obiect propriu.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS7017: Element implicitly has an 'any' type because type 'typeof globalThis' has no index signature. Configurarea e pusă pe obiectul global, ca să fie citită din alt cod. Declar-o cu tipul ei ca programul să afișeze Tema: dark și apoi Limba: ro.
globalThis.configurare = { tema: 'dark', limba: 'ro' };
function afiseaza() {
console.log(`Tema: ${globalThis.configurare.tema}`);
console.log(`Limba: ${globalThis.configurare.limba}`);
}
afiseaza();Tema: dark Limba: ro
Indiciu
Într-un script, o declarație declare var la început adaugă un nume pe obiectul global.
Reparația
declare var configurare: { tema: string; limba: string };
globalThis.configurare = { tema: 'dark', limba: 'ro' };
function afiseaza() {
console.log(`Tema: ${globalThis.configurare.tema}`);
console.log(`Limba: ${globalThis.configurare.limba}`);
}
afiseaza();De ce merge
Tipul typeof globalThis conține doar numele declarate, iar configurare nu era printre ele. declare var configurare: {...} nu creează valoarea, doar îi spune compilatorului că obiectul global are această proprietate și ce tip are. Atribuirea și citirile devin verificate, iar programul afișează Tema: dark și Limba: ro.
Alte forme ale mesajului
error TS7017: Element implicitly has an 'any' type because type 'typeof globalThis' has no index signature.
Cum o eviți pe viitor
- Evită variabilele globale: exportă valorile partajate dintr-un modul și importă-le unde ai nevoie.
- Când chiar ai nevoie de una (setată de un script extern, de exemplu), declar-o o singură dată, într-un fișier
globals.d.tscudeclare global. - În browser, același lucru apare ca
Property 'x' does not exist on type 'Window & typeof globalThis'(TS2339): reparația e aceeași declarație. - Nu folosi
(globalThis as any).xdecât temporar: pierzi verificarea tipului.
Întrebări frecvente
De ce declare var și nu declare let?
Doar var (și funcțiile) de la nivelul unui script devin proprietăți ale obiectului global. let și const sunt globale ca nume, dar nu apar pe globalThis, deci globalThis.x tot ar da eroare.
Pe window.x primesc altă eroare. E aceeași problemă?
Da. Cu biblioteca dom, window are tipul Window & typeof globalThis, iar o proprietate nedeclarată dă TS2339 (Property 'x' does not exist on type 'Window & typeof globalThis'). Declari variabila la fel, cu declare global { var x: T } sau extinzând interface Window.
Erori înrudite
error TS7041: The containing arrow function captures the global value of 'this'. Folosești this într-o funcție săgeată definită la nivelul fișierului, de obicei ca metodă într-un obiect literal. Săgeata nu are this propriu, ia this-ul global. Scrie metoda cu sintaxa afiseaza() { ... } în loc de afiseaza: () => ... error TS2669: Augmentations for the global scope can only be directly nested in external modules or ambient module declarations. Ai scris declare global { ... } într-un fișier care nu e modul (nu are niciun import sau export). Adaugă export {}; în fișier ca să devină modul, sau, într-un script, scoate wrapper-ul și scrie direct declare var nume: Tip;. error TS7053: Element implicitly has an 'any' type because expression of type 'string' can't be used to index type '{ mere: number; pere: number; }'. Accesezi un obiect cu paranteze drepte și o cheie de tip string oarecare, dar obiectul are doar câteva chei cunoscute. Restrânge cheia la keyof typeof obiect, sau tipează obiectul ca Record<string, number> dacă are chei dinamice. Învață TypeScript de la zero, cu exerciții la fiecare lecție
Curs TypeScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
