Get and robustly cache all JS language-level intrinsics at first require time. 

Get and robustly cache all JS language-level intrinsics at first require time

ljharb

get-intrinsic

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)

and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [v1.2.2](https://github.com/ljharb/get-intrinsic/compare/v1.2.1...v1.2.2) - 2023-10-20

- [Dev Deps] update `@ljharb/eslint-config`, `aud`, `call-bind`, `es-abstract`, `mock-property`, `object-inspect`, `tape` [`f51bcf2`](https://github.com/ljharb/get-intrinsic/commit/f51bcf26412d58d17ce17c91c9afd0ad271f0762)

- [Refactor] use `hasown` instead of `has` [`18d14b7`](https://github.com/ljharb/get-intrinsic/commit/18d14b799bea6b5765e1cec91890830cbcdb0587)

- [Deps] update `function-bind` [`6e109c8`](https://github.com/ljharb/get-intrinsic/commit/6e109c81e03804cc5e7824fb64353cdc3d8ee2c7)

## [v1.2.1](https://github.com/ljharb/get-intrinsic/compare/v1.2.0...v1.2.1) - 2023-05-13

- [Fix] avoid a crash in envs without `__proto__` [`7bad8d0`](https://github.com/ljharb/get-intrinsic/commit/7bad8d061bf8721733b58b73a2565af2b6756b64)

- [Dev Deps] update `es-abstract` [`c60e6b7`](https://github.com/ljharb/get-intrinsic/commit/c60e6b7b4cf9660c7f27ed970970fd55fac48dc5)

## [v1.2.0](https://github.com/ljharb/get-intrinsic/compare/v1.1.3...v1.2.0) - 2023-01-19

- [actions] update checkout action [`ca6b12f`](https://github.com/ljharb/get-intrinsic/commit/ca6b12f31eaacea4ea3b055e744cd61623385ffb)

- [Dev Deps] update `@ljharb/eslint-config`, `es-abstract`, `object-inspect`, `tape` [`41a3727`](https://github.com/ljharb/get-intrinsic/commit/41a3727d0026fa04273ae216a5f8e12eefd72da8)

- [Fix] ensure `Error.prototype` is undeniable [`c511e97`](https://github.com/ljharb/get-intrinsic/commit/c511e97ae99c764c4524b540dee7a70757af8da3)

- [Dev Deps] update `aud`, `es-abstract`, `tape` [`1bef8a8`](https://github.com/ljharb/get-intrinsic/commit/1bef8a8fd439ebb80863199b6189199e0851ac67)

- [Dev Deps] update `aud`, `es-abstract` [`0d41f16`](https://github.com/ljharb/get-intrinsic/commit/0d41f16bcd500bc28b7bfc98043ebf61ea081c26)

- [New] add `BigInt64Array` and `BigUint64Array` [`a6cca25`](https://github.com/ljharb/get-intrinsic/commit/a6cca25f29635889b7e9bd669baf9e04be90e48c)

- [Tests] use `gopd` [`ecf7722`](https://github.com/ljharb/get-intrinsic/commit/ecf7722240d15cfd16edda06acf63359c10fb9bd)

## [v1.1.3](https://github.com/ljharb/get-intrinsic/compare/v1.1.2...v1.1.3) - 2022-09-12

- [Dev Deps] update `es-abstract`, `es-value-fixtures`, `tape` [`07ff291`](https://github.com/ljharb/get-intrinsic/commit/07ff291816406ebe5a12d7f16965bde0942dd688)

- [Fix] properly check for % signs [`50ac176`](https://github.com/ljharb/get-intrinsic/commit/50ac1760fe99c227e64eabde76e9c0e44cd881b5)

## [v1.1.2](https://github.com/ljharb/get-intrinsic/compare/v1.1.1...v1.1.2) - 2022-06-08

- [Fix] properly validate against extra % signs [`#16`](https://github.com/ljharb/get-intrinsic/issues/16)

- [actions] reuse common workflows [`0972547`](https://github.com/ljharb/get-intrinsic/commit/0972547efd0abc863fe4c445a6ca7eb4f8c6901d)

- [meta] use `npmignore` to autogenerate an npmignore file [`5ba0b51`](https://github.com/ljharb/get-intrinsic/commit/5ba0b51d8d8d4f1c31d426d74abc0770fd106bad)

- [actions] use `node/install` instead of `node/run`; use `codecov` action [`c364492`](https://github.com/ljharb/get-intrinsic/commit/c364492af4af51333e6f81c0bf21fd3d602c3661)

- [Dev Deps] update `eslint`, `@ljharb/eslint-config`, `aud`, `auto-changelog`, `es-abstract`, `object-inspect`, `tape` [`dc04dad`](https://github.com/ljharb/get-intrinsic/commit/dc04dad86f6e5608775a2640cb0db5927ae29ed9)

- [Dev Deps] update `eslint`, `@ljharb/eslint-config`, `es-abstract`, `object-inspect`, `safe-publish-latest`, `tape` [`1c14059`](https://github.com/ljharb/get-intrinsic/commit/1c1405984e86dd2dc9366c15d8a0294a96a146a5)

- [Tests] use `mock-property` [`b396ef0`](https://github.com/ljharb/get-intrinsic/commit/b396ef05bb73b1d699811abd64b0d9b97997fdda)

- [Dev Deps] update `eslint`, `@ljharb/eslint-config`, `aud`, `auto-changelog`, `object-inspect`, `tape` [`c2c758d`](https://github.com/ljharb/get-intrinsic/commit/c2c758d3b90af4fef0a76910d8d3c292ec8d1d3e)

- [Dev Deps] update `eslint`, `@ljharb/eslint-config`, `aud`, `es-abstract`, `es-value-fixtures`, `object-inspect`, `tape` [`29e3c09`](https://github.com/ljharb/get-intrinsic/commit/29e3c091c2bf3e17099969847e8729d0e46896de)

- [actions] update codecov uploader [`8cbc141`](https://github.com/ljharb/get-intrinsic/commit/8cbc1418940d7a8941f3a7985cbc4ac095c5e13d)

- [Dev Deps] update `@ljharb/eslint-config`, `es-abstract`, `es-value-fixtures`, `object-inspect`, `tape` [`10b6f5c`](https://github.com/ljharb/get-intrinsic/commit/10b6f5c02593fb3680c581d696ac124e30652932)

- [readme] add github actions/codecov badges [`4e25400`](https://github.com/ljharb/get-intrinsic/commit/4e25400d9f51ae9eb059cbe22d9144e70ea214e8)

- [Tests] use `for-each` instead of `foreach` [`c05b957`](https://github.com/ljharb/get-intrinsic/commit/c05b957ad9a7bc7721af7cc9e9be1edbfe057496)

- [Dev Deps] update `es-abstract` [`29b05ae`](https://github.com/ljharb/get-intrinsic/commit/29b05aec3e7330e9ad0b8e0f685a9112c20cdd97)

- [meta] use `prepublishOnly` script for npm 7+ [`95c285d`](https://github.com/ljharb/get-intrinsic/commit/95c285da810516057d3bbfa871176031af38f05d)

- [Deps] update `has-symbols` [`593cb4f`](https://github.com/ljharb/get-intrinsic/commit/593cb4fb38e7922e40e42c183f45274b636424cd)

- [readme] fix repo URLs [`1c8305b`](https://github.com/ljharb/get-intrinsic/commit/1c8305b5365827c9b6fc785434aac0e1328ff2f5)

- [Deps] update `has-symbols` [`c7138b6`](https://github.com/ljharb/get-intrinsic/commit/c7138b6c6d73132d859471fb8c13304e1e7c8b20)

- [Dev Deps] remove unused `has-bigints` [`bd63aff`](https://github.com/ljharb/get-intrinsic/commit/bd63aff6ad8f3a986c557fcda2914187bdaab359)

## [v1.1.1](https://github.com/ljharb/get-intrinsic/compare/v1.1.0...v1.1.1) - 2021-02-03

- [meta] export `./package.json` [`#9`](https://github.com/ljharb/get-intrinsic/issues/9)

- [readme] flesh out the readme; use `evalmd` [`d12f12c`](https://github.com/ljharb/get-intrinsic/commit/d12f12c15345a0a0772cc65a7c64369529abd614)

- [eslint] set up proper globals config [`5a8c098`](https://github.com/ljharb/get-intrinsic/commit/5a8c0984e3319d1ac0e64b102f8ec18b64e79f36)

- [Dev Deps] update `eslint` [`7b9a5c0`](https://github.com/ljharb/get-intrinsic/commit/7b9a5c0d31a90ca1a1234181c74988fb046701cd)

## [v1.1.0](https://github.com/ljharb/get-intrinsic/compare/v1.0.2...v1.1.0) - 2021-01-25

- [Refactor] delay `Function` eval until syntax-derived values are requested [`#3`](https://github.com/ljharb/get-intrinsic/issues/3)

- [Tests] migrate tests to Github Actions [`2ab762b`](https://github.com/ljharb/get-intrinsic/commit/2ab762b48164aea8af37a40ba105bbc8246ab8c4)

- [meta] do not publish github action workflow files [`5e7108e`](https://github.com/ljharb/get-intrinsic/commit/5e7108e4768b244d48d9567ba4f8a6cab9c65b8e)

- [Tests] add some coverage [`01ac7a8`](https://github.com/ljharb/get-intrinsic/commit/01ac7a87ac29738567e8524cd8c9e026b1fa8cb3)

- [Dev Deps] update `eslint`, `@ljharb/eslint-config`, `call-bind`, `es-abstract`, `tape`; add `call-bind` [`911b672`](https://github.com/ljharb/get-intrinsic/commit/911b672fbffae433a96924c6ce013585e425f4b7)

- [Refactor] rearrange evalled constructors a bit [`7e7e4bf`](https://github.com/ljharb/get-intrinsic/commit/7e7e4bf583f3799c8ac1c6c5e10d2cb553957347)

- [meta] add Automatic Rebase and Require Allow Edits workflows [`0199968`](https://github.com/ljharb/get-intrinsic/commit/01999687a263ffce0a3cb011dfbcb761754aedbc)

## [v1.0.2](https://github.com/ljharb/get-intrinsic/compare/v1.0.1...v1.0.2) - 2020-12-17

- [Fix] Throw for non‑existent intrinsics [`68f873b`](https://github.com/ljharb/get-intrinsic/commit/68f873b013c732a05ad6f5fc54f697e55515461b)

- [Fix] Throw for non‑existent segments in the intrinsic path [`8325dee`](https://github.com/ljharb/get-intrinsic/commit/8325deee43128f3654d3399aa9591741ebe17b21)

- [Dev Deps] update `eslint`, `@ljharb/eslint-config`, `aud`, `has-bigints`, `object-inspect` [`0c227a7`](https://github.com/ljharb/get-intrinsic/commit/0c227a7d8b629166f25715fd242553892e458525)

- [meta] do not lint coverage output [`70d2419`](https://github.com/ljharb/get-intrinsic/commit/70d24199b620043cd9110fc5f426d214ebe21dc9)

## [v1.0.1](https://github.com/ljharb/get-intrinsic/compare/v1.0.0...v1.0.1) - 2020-10-30

- [Tests] gather coverage data on every job [`d1d280d`](https://github.com/ljharb/get-intrinsic/commit/d1d280dec714e3f0519cc877dbcb193057d9cac6)

- [Fix] add missing dependencies [`5031771`](https://github.com/ljharb/get-intrinsic/commit/5031771bb1095b38be88ce7c41d5de88718e432e)

- [Tests] use `es-value-fixtures` [`af48765`](https://github.com/ljharb/get-intrinsic/commit/af48765a23c5323fb0b6b38dbf00eb5099c7bebc)

// eslint-disable-next-line consistent-return

var getEvalledConstructor = function (expressionSyntax) {

		return $Function('"use strict"; return (' + expressionSyntax + ').constructor;')();

var $gOPD = Object.getOwnPropertyDescriptor;

		$gOPD = null; // this is IE 8, which has a broken gOPD

			// eslint-disable-next-line no-unused-expressions, no-caller, no-restricted-properties

			arguments.callee; // IE 8 does not throw here

				// IE 8 throws on Object.getOwnPropertyDescriptor(arguments, '')

				return $gOPD(arguments, 'callee').get;

var hasSymbols = require('has-symbols')();

var getProto = Object.getPrototypeOf || (

		? function (x) { return x.__proto__; } // eslint-disable-line no-proto

var TypedArray = typeof Uint8Array === 'undefined' || !getProto ? undefined : getProto(Uint8Array);

	'%AggregateError%': typeof AggregateError === 'undefined' ? undefined : AggregateError,

	'%ArrayBuffer%': typeof ArrayBuffer === 'undefined' ? undefined : ArrayBuffer,

	'%ArrayIteratorPrototype%': hasSymbols && getProto ? getProto([][Symbol.iterator]()) : undefined,

	'%AsyncFromSyncIteratorPrototype%': undefined,

	'%Atomics%': typeof Atomics === 'undefined' ? undefined : Atomics,

	'%BigInt%': typeof BigInt === 'undefined' ? undefined : BigInt,

	'%BigInt64Array%': typeof BigInt64Array === 'undefined' ? undefined : BigInt64Array,

	'%BigUint64Array%': typeof BigUint64Array === 'undefined' ? undefined : BigUint64Array,

	'%DataView%': typeof DataView === 'undefined' ? undefined : DataView,

	'%decodeURIComponent%': decodeURIComponent,

	'%encodeURIComponent%': encodeURIComponent,

	'%eval%': eval, // eslint-disable-line no-eval

	'%Float32Array%': typeof Float32Array === 'undefined' ? undefined : Float32Array,

	'%Float64Array%': typeof Float64Array === 'undefined' ? undefined : Float64Array,

	'%FinalizationRegistry%': typeof FinalizationRegistry === 'undefined' ? undefined : FinalizationRegistry,

	'%Int8Array%': typeof Int8Array === 'undefined' ? undefined : Int8Array,

	'%Int16Array%': typeof Int16Array === 'undefined' ? undefined : Int16Array,

	'%Int32Array%': typeof Int32Array === 'undefined' ? undefined : Int32Array,

	'%IteratorPrototype%': hasSymbols && getProto ? getProto(getProto([][Symbol.iterator]())) : undefined,

	'%JSON%': typeof JSON === 'object' ? JSON : undefined,

	'%Map%': typeof Map === 'undefined' ? undefined : Map,

	'%MapIteratorPrototype%': typeof Map === 'undefined' || !hasSymbols || !getProto ? undefined : getProto(new Map()[Symbol.iterator]()),

var $concat = bind.call(Function.call, Array.prototype.concat);

var $spliceApply = bind.call(Function.apply, Array.prototype.splice);

var $replace = bind.call(Function.call, String.prototype.replace);

var $strSlice = bind.call(Function.call, String.prototype.slice);

var $exec = bind.call(Function.call, RegExp.prototype.exec);

/* adapted from https://github.com/lodash/lodash/blob/4.17.15/dist/lodash.js#L6735-L6744 */

var rePropName = /[^%.[\]]+|\[(?:(-?\d+(?:\.\d+)?)|(["'])((?:(?!\2)[^\\]|\\.)*?)\2)\]|(?=(?:\.|\[\])(?:\.|\[\]|%$))/g;

var reEscapeChar = /\$\$?/g; /** Used to match backslashes in property paths. */

var stringToPath = function stringToPath(string) {

		throw new $SyntaxError('invalid intrinsic syntax, expected closing `%`');

	} else if (last === '%' && first !== '%') {

		throw new $SyntaxError('invalid intrinsic syntax, expected opening `%`');

	$replace(string, rePropName, function (match, number, quote, subString) {

		result[result.length] = quote ? $replace(subString, reEscapeChar, '$1') : number || match;

var getBaseIntrinsic = function getBaseIntrinsic(name, allowMissing) {

	if (hasOwn(LEGACY_ALIASES, intrinsicName)) {

	if (hasOwn(INTRINSICS, intrinsicName)) {

		if (typeof value === 'undefined' && !allowMissing) {

			throw new $TypeError('intrinsic ' + name + ' exists, but is not available. Please file an issue!');

	throw new $SyntaxError('intrinsic ' + name + ' does not exist!');

module.exports = function GetIntrinsic(name, allowMissing) {

	if (typeof name !== 'string' || name.length === 0) {

		throw new $TypeError('intrinsic name must be a non-empty string');

	if (arguments.length > 1 && typeof allowMissing !== 'boolean') {

		throw new $TypeError('"allowMissing" argument must be a boolean');

	if ($exec(/^%?[^%]*%?$/, name) === null) {

		throw new $SyntaxError('`%` may not be present anywhere but at the beginning and end of the intrinsic name');

	var intrinsicBaseName = parts.length > 0 ? parts[0] : '';

	var intrinsic = getBaseIntrinsic('%' + intrinsicBaseName + '%', allowMissing);

		$spliceApply(parts, $concat([0, 1], alias));

	for (var i = 1, isOwn = true; i < parts.length; i += 1) {

				(first === '"' || first === "'" || first === '`')

				|| (last === '"' || last === "'" || last === '`')

			throw new $SyntaxError('property names with quotes must have matching quotes');

		if (part === 'constructor' || !isOwn) {

		intrinsicRealName = '%' + intrinsicBaseName + '%';

		if (hasOwn(INTRINSICS, intrinsicRealName)) {

			value = INTRINSICS[intrinsicRealName];

	"description": "Get and robustly cache all JS language-level intrinsics at first require time",

		"prepack": "npmignore --auto --commentLines=autogenerated",

		"prepublish": "not-in-publish || npm run prepublishOnly",

		"prepublishOnly": "safe-publish-latest",

		"tests-only": "nyc tape 'test/**/*.js'",

		"version": "auto-changelog && git add CHANGELOG.md",

		"postversion": "auto-changelog && git add CHANGELOG.md && git commit --no-edit --amend && git tag -f \"v$(node -e \"console.log(require('./package.json').version)\")\""

		"url": "git+https://github.com/ljharb/get-intrinsic.git"

	"author": "Jordan Harband <ljharb@gmail.com>",

		"url": "https://github.com/sponsors/ljharb"

		"url": "https://github.com/ljharb/get-intrinsic/issues"

	"homepage": "https://github.com/ljharb/get-intrinsic#readme",

		"make-async-generator-function": "^1.0.0",

		@@ -217,3 +217,3 @@ 'use strict';
		var bind = require('function-bind');
		var hasOwn = require('has');
		var hasOwn = require('hasown');
		var $concat = bind.call(Function.call, Array.prototype.concat);
		@@ -220,0 +220,0 @@ var $spliceApply = bind.call(Function.apply, Array.prototype.splice);

		{
		"name": "get-intrinsic",
		"version": "1.2.1",
		"version": "1.2.2",
		"description": "Get and robustly cache all JS language-level intrinsics at first require time",
		@@ -51,7 +51,7 @@ "main": "index.js",
		"devDependencies": {
		"@ljharb/eslint-config": "^21.0.1",
		"aud": "^2.0.2",
		"@ljharb/eslint-config": "^21.1.0",
		"aud": "^2.0.3",
		"auto-changelog": "^2.4.0",
		"call-bind": "^1.0.2",
		"es-abstract": "^1.21.2",
		"call-bind": "^1.0.5",
		"es-abstract": "^1.22.2",
		"es-value-fixtures": "^1.4.2",
		@@ -65,8 +65,8 @@ "eslint": "=8.8.0",
		"make-generator-function": "^2.0.0",
		"mock-property": "^1.0.0",
		"mock-property": "^1.0.2",
		"npmignore": "^0.3.0",
		"nyc": "^10.3.2",
		"object-inspect": "^1.12.3",
		"object-inspect": "^1.13.1",
		"safe-publish-latest": "^2.0.0",
		"tape": "^5.6.3"
		"tape": "^5.7.2"
		},
		@@ -82,6 +82,6 @@ "auto-changelog": {
		"dependencies": {
		"function-bind": "^1.1.1",
		"has": "^1.0.3",
		"function-bind": "^1.1.2",
		"has-proto": "^1.0.1",
		"has-symbols": "^1.0.3"
		"has-symbols": "^1.0.3",
		"hasown": "^2.0.0"
		},
		@@ -88,0 +88,0 @@ "testling": {

Improved metrics

Dependency changes

		@@ -8,2 +8,10 @@ # Changelog

		## [v1.2.2](https://github.com/ljharb/get-intrinsic/compare/v1.2.1...v1.2.2) - 2023-10-20

		### Commits

		- [Dev Deps] update `@ljharb/eslint-config`, `aud`, `call-bind`, `es-abstract`, `mock-property`, `object-inspect`, `tape` [`f51bcf2`](https://github.com/ljharb/get-intrinsic/commit/f51bcf26412d58d17ce17c91c9afd0ad271f0762)
		- [Refactor] use `hasown` instead of `has` [`18d14b7`](https://github.com/ljharb/get-intrinsic/commit/18d14b799bea6b5765e1cec91890830cbcdb0587)
		- [Deps] update `function-bind` [`6e109c8`](https://github.com/ljharb/get-intrinsic/commit/6e109c81e03804cc5e7824fb64353cdc3d8ee2c7)

		## [v1.2.1](https://github.com/ljharb/get-intrinsic/compare/v1.2.0...v1.2.1) - 2023-05-13
		@@ -10,0 +18,0 @@