globalThis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Die globale Eigenschaft globalThis enthält den Wert von globalem this, der in der Regel dem globalen Objekt entspricht.
Probieren Sie es aus
function canMakeHTTPRequest() {
return typeof globalThis.XMLHttpRequest === "function";
}
console.log(canMakeHTTPRequest());
// Expected output (in a browser): true
Wert
Das globale this-Objekt.
Eigenschaften von globalThis | |
|---|---|
| Schreibbar | ja |
| Aufzählbar | nein |
| Konfigurierbar | ja |
Hinweis:
Die Eigenschaft globalThis ist konfigurierbar und beschreibbar. So können Entwickler sie bei der Ausführung nicht vertrauenswürdigen Codes verbergen und verhindern, dass das globale Objekt offengelegt wird.
Beschreibung
Historisch erforderte der Zugriff auf das globale Objekt in verschiedenen JavaScript-Umgebungen unterschiedliche Syntax. Im Web können Sie window, self oder frames verwenden – in Web Workern funktioniert jedoch nur self. In Node.js funktioniert keines davon; stattdessen müssen Sie global verwenden. Das Schlüsselwort this konnte innerhalb von Funktionen verwendet werden, die nicht im Strict Mode ausgeführt werden. In Modulen und innerhalb von Funktionen im Strict Mode ist this jedoch undefined. Sie können auch Function('return this')() verwenden. Umgebungen, die eval() deaktivieren, etwa durch CSP in Browsern, verhindern jedoch, dass Function auf diese Weise verwendet wird.
Die Eigenschaft globalThis bietet eine standardisierte Möglichkeit, umgebungsübergreifend auf den globalen this-Wert und damit auf das globale Objekt selbst zuzugreifen. Anders als bei ähnlichen Eigenschaften wie window und self ist gewährleistet, dass sie sowohl in Window- als auch in Nicht-Window-Kontexten funktioniert. So können Sie einheitlich auf das globale Objekt zugreifen, ohne wissen zu müssen, in welcher Umgebung der Code ausgeführt wird. Um sich den Namen zu merken: Im globalen Gültigkeitsbereich ist der Wert von this gleich globalThis.
Hinweis:
globalThis entspricht im Allgemeinen dem globalen Objekt: Wenn Sie globalThis Eigenschaften hinzufügen, werden diese zu globalen Variablen. Dies gilt für Browser und Node.js. Host-Umgebungen dürfen für globalThis jedoch einen anderen Wert bereitstellen, der nicht mit dem globalen Objekt zusammenhängt.
HTML und WindowProxy
In vielen Engines verweist globalThis direkt auf das globale Objekt. In Webbrowsern verweist es aufgrund von Sicherheitsaspekten bei iframes und fensterübergreifenden Zugriffen jedoch auf einen WindowProxy, der das eigentliche globale Objekt umgibt. Auf dieses können Sie nicht direkt zugreifen. Diese Unterscheidung ist bei der üblichen Verwendung selten relevant, sollte aber bekannt sein.
Namensgebung
Mehrere andere naheliegende Namen wie self und global wurden nicht berücksichtigt, da sie die Kompatibilität mit bestehendem Code beeinträchtigen könnten. Weitere Einzelheiten finden Sie im Dokument zur Namensgebung des Sprachvorschlags.
globalThis ist wörtlich genommen der globale this-Wert. Er entspricht dem Wert von this in einer Funktion, die nicht im Strict Mode ausgeführt und ohne Objekt aufgerufen wird. Er ist auch der Wert von this im globalen Gültigkeitsbereich eines Skripts.
Beispiele
>Das globale Objekt umgebungsübergreifend ermitteln
Normalerweise muss das globale Objekt nicht ausdrücklich angegeben werden – seine Eigenschaften sind automatisch als globale Variablen zugänglich.
console.log(window.Math === Math); // true
Ein Fall, in dem ausdrücklich auf das globale Objekt zugegriffen werden muss, ist jedoch das Schreiben von Eigenschaften auf das Objekt, üblicherweise für Polyfills.
Vor globalThis war Function('return this')() die einzige zuverlässige plattformübergreifende Möglichkeit, das globale Objekt einer Umgebung zu erhalten. Dies führt unter bestimmten Einstellungen jedoch zu Verstößen gegen die CSP. Deshalb verwendeten Entwickler eine Fallunterscheidung wie die folgende (leicht angepasst aus dem ursprünglichen core-js-Quellcode):
function check(it) {
// Math is known to exist as a global in every environment.
return it && it.Math === Math && it;
}
const globalObject =
check(typeof window === "object" && window) ||
check(typeof self === "object" && self) ||
check(typeof global === "object" && global) ||
// This returns undefined when running in strict mode
(function () {
return this;
})() ||
Function("return this")();
Nachdem das globale Objekt ermittelt wurde, können wir darauf neue globale Eigenschaften definieren. Beispielsweise können wir eine Implementierung für Intl hinzufügen:
if (typeof globalObject.Intl === "undefined") {
// No Intl in this environment; define our own on the global scope
Object.defineProperty(globalObject, "Intl", {
value: {
// Our Intl implementation
},
enumerable: false,
configurable: true,
writable: true,
});
}
Mit globalThis ist die zusätzliche umgebungsübergreifende Suche nach dem globalen Objekt nicht mehr nötig:
if (typeof globalThis.Intl === "undefined") {
Object.defineProperty(globalThis, "Intl", {
value: {
// Our Intl implementation
},
enumerable: false,
configurable: true,
writable: true,
});
}
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-globalthis> |