...
Eroare TypeScript · Mediu, biblioteci și module

error TS7017: Element implicitly has an 'any' type because type 'typeof globalThis' has no index signature.

Pe scurt

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

Greșit
TypeScript
globalThis.configurare = { tema: 'dark' };
Corect
TypeScript
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

Greșit
TypeScript
export {};
globalThis.versiune = '1.0';
Corect
TypeScript
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

Greșit
TypeScript
const f = () => this.total;
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
globalThis.configurare = { tema: 'dark', limba: 'ro' };

function afiseaza() {
  console.log(`Tema: ${globalThis.configurare.tema}`);
  console.log(`Limba: ${globalThis.configurare.limba}`);
}

afiseaza();
După reparație, programul afișează
Tema: dark
Limba: ro
Indiciu

Într-un script, o declarație declare var la început adaugă un nume pe obiectul global.

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.ts cu declare 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).x decâ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

← Toate erorile TypeScript

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ță 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.