globalThis Version Badge

github actions coverage dependency status dev dependency status License Downloads

npm badge

An ECMAScript spec-compliant polyfill/shim for globalThis. Invoke its "shim" method to shim globalThis if it is unavailable.

This package implements the es-shim API interface. It works in an ES3-supported environment and complies with the spec proposal.

Most common usage: js var globalThis = require('globalthis')(); // returns native globalThis if compliant /* or */ var globalThis = require('globalthis/polyfill')(); // returns native globalThis if compliant

Example

```js var assert = require('assert');

// the below function is not CSP-compliant, but reliably gets the // global object in sloppy mode in every engine. var getGlobal = Function('return this');

assert.equal(globalThis, getGlobal()); ```

``js /* whenglobalThis` is not present / var shimmedGlobal = require('globalthis').shim(); / or */ var shimmedGlobal = require('globalthis/shim')();

assert.equal(shimmedGlobal, globalThis); assert.equal(shimmedGlobal, getGlobal()); ```

``js /* whenglobalThis` is present */ var shimmedGlobal = require('globalthis').shim();

assert.equal(shimmedGlobal, globalThis); assert.equal(shimmedGlobal, getGlobal()); ```

Tests

Simply clone the repo, npm install, and run npm test