globalthis

What is globalthis?

The globalthis npm package provides a polyfill for the global `globalThis` object, which is a standard way to access the global object (e.g., `window` in browsers, `global` in Node.js) in a universal manner across different JavaScript environments. This package ensures that you can reliably use `globalThis` in environments where it might not be natively supported.

What are globalthis's main functionalities?

Polyfill for globalThis

This code snippet demonstrates how to polyfill the global `globalThis` object using the globalthis package. After requiring and invoking the package, you can reliably use `globalThis` in your code to refer to the global object.

require('globalthis')(); // This will polyfill globalThis if it doesn't exist

Other packages similar to globalthis

core-js

core-js is a modular standard library for JavaScript, which includes polyfills for ECMAScript up to the latest standards. It provides more comprehensive polyfills than globalthis, including polyfills for `globalThis`. It is more feature-rich but also larger in size compared to the focused functionality of globalthis.

es6-shim

es6-shim is a shim that provides compatibility shims so that legacy JavaScript engines behave as closely as possible to ECMAScript 6 (Harmony). It includes a polyfill for `globalThis` among many other features. Like core-js, it is more extensive than globalthis but also more heavyweight.

README

globalThis

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:

var globalThis = require('globalthis')(); // returns native globalThis if compliant
	/* or */
var globalThis = require('globalthis/polyfill')(); // returns native globalThis if compliant

Example

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());

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

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

/* when `globalThis` 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

Changelog

v1.0.1 - 2019-12-15

Fixed

• [Refactor] only use global in node; only check browser globals in browsers #2

Commits

• [Tests] use shared travis-ci configs edb1cc9
• [Tests] remove jscs 1847ac2
• [meta] add auto-changelog 933c381
• [Dev Deps] update eslint, @ljharb/eslint-config, browserify, tape 93310bc
• [actions] add automatic rebasing / merge commit blocking 231dec5
• [Dev Deps] update eslint, @ljharb/eslint-config, browserify, covert, is, tape e50c1f6
• [Tests] use npx aud instead of nsp or npm audit with hoops 4abd340
• [meta] add funding field 2d1f9eb
• [meta] remove unused deps 5bd6bef
• readme: Fix casing + phrasing 66379cc
• [Deps] update define-properties, object-keys 4585e5a
• fix issue with Webpack's CaseSensitivePathsPlugin 842e84e