La propriété globale globalThis renvoie l'objet global de plus haut niveau.

Syntaxe

globalThis

Description

Par le passé, il était nécessaire d'utiliser différentes syntaxes pour différents environnements afin d'accéder à la portée globale. Sur le Web, on peut utiliser window, self ou frames ; pour les web workers, seul self peut être employé ; pour Node.js aucun de ces mots-clés ne fonctionne et il faut utiliser global.
Le mot-clé this pouvait être utilisé à l'intérieur des fonctions en mode non-strict mais vaudra sinon undefined dans les modules et dans les fonctions utilisant le mode strict.

La propriété globalThis fournit une méthode standard d'accès à l'objet global, quel que soit l'environnement. Contrairement aux propriétés window et self, ce mot-clé fonctionnera quel que soit le contexte (que celui-ci soit doté de fenêtres ou non). Ainsi, on peut accéder à l'objet global de façon homogène, quel que soit l'environnement dans lequel le code est utilisé.

Pour mieux mémoriser ce nom, on se rappellera que la valeur de this dans la portée globale est globalThis.

Nommage

D'autres noms furent proposés pour cette fonctionnalité (tels que self et global) mais ils furent écartés car ils pouvaient entraîner des problèmes de compatibilité avec du code existant.

Exemples

Avant l'introduction de globalThis, la seule façon qui permettait d'obtenir l'objet global de l'environnement de façon homogène était Function('return this')(). Toutefois, cela enfreignait certaines règles CSP avec certains réglages et es6-shim, par exemple, devait utiliser une logique conditionnelle :

var getGlobal = function () { 
  if (typeof self !== 'undefined') { return self; } 
  if (typeof window !== 'undefined') { return window; } 
  if (typeof global !== 'undefined') { return global; } 
  throw new Error("impossible de trouver l'objet global"); 
}; 

var globals = getGlobal(); 

if (typeof globals.setTimeout !== 'function') { 
  // pas de setTimeout pour cet environnement 
}

Avec globalThis, il n'est plus nécessaire de parcourir les différents mots-clés des différents environnements :

if (typeof globalThis.setTimeout !== 'function') {
  // pas de setTimeout pour cet environnement
}

Spécifications

Spécification État Commentaires
Proposition pour globalThis Proposition de niveau 3 (stage 3)  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
globalThisChrome Support complet 71Edge Aucun support NonFirefox Support complet 65IE Aucun support NonOpera Aucun support NonSafari Support complet 12.1WebView Android Support complet 71Chrome Android Support complet 71Edge Mobile Aucun support NonFirefox Android Support complet 65Opera Android Aucun support NonSafari iOS Support complet 12.2Samsung Internet Android Aucun support Nonnodejs Support complet 12.0.0

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : SphinxKnight, mdnwebdocs-bot
Dernière mise à jour par : SphinxKnight,