@babel/plugin-transform-runtime

What is @babel/plugin-transform-runtime?

The @babel/plugin-transform-runtime package is a Babel plugin that enables the re-use of Babel's injected helper code to save on codesize. It also allows you to use built-ins such as Promise or WeakMap, static methods like Array.from or Object.assign, instance methods like Array.prototype.includes, and generator functions in environments that do not natively support them.

What are @babel/plugin-transform-runtime's main functionalities?

Helpers

This feature allows Babel to transform code by extracting common helper functions into shared modules to reduce code duplication in the output.

"use strict";\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nvar Foo = function Foo() {\n  _classCallCheck(this, Foo);\n};

Polyfills for instance methods

This feature enables the use of instance methods like 'includes' on arrays, which are part of the ECMAScript specifications but may not be available in all environments.

import \"core-js/stable\";\nimport \"regenerator-runtime/runtime\";\n\n[1, 2, 3].includes(2);

Built-ins

This feature allows the use of new built-in objects like Promise, which are part of the ECMAScript specifications but may not be natively supported in all environments.

import \"core-js/stable\";\nimport \"regenerator-runtime/runtime\";\n\nvar promise = new Promise();

Generator functions

This feature allows the use of generator functions, which can be used to perform asynchronous operations in a synchronous-like manner.

import \"core-js/stable\";\nimport \"regenerator-runtime/runtime\";\n\nfunction* aGenerator() {\n  yield 1;\n  yield 2;\n  yield 3;\n}

Other packages similar to @babel/plugin-transform-runtime

core-js

Core-js is a modular standard library for JavaScript, which includes polyfills for ECMAScript up to 2021. It's similar to @babel/plugin-transform-runtime in that it provides polyfills for features not available in older environments, but it's more comprehensive and can be used without Babel.

regenerator-runtime

Regenerator-runtime is a standalone runtime for Regenerator-compiled generator and async functions. It's similar to the generator function handling part of @babel/plugin-transform-runtime but does not include other transformations or helpers.

babel-polyfill

Babel-polyfill is now deprecated in favor of @babel/preset-env and core-js. It used to provide a full set of polyfills for Babel users. It was similar to @babel/plugin-transform-runtime but included the polyfills in the global scope, which could lead to conflicts.

README

@babel/plugin-transform-runtime

Externalise references to helpers and builtins, automatically polyfilling your code without polluting globals

See our website @babel/plugin-transform-runtime for more information.

Install

Using npm:

npm install --save-dev @babel/plugin-transform-runtime

or using yarn:

yarn add @babel/plugin-transform-runtime --dev

Changelog

v7.25.7 (2024-10-02)

:bug: Bug Fix

• babel-helper-validator-identifier
  • #16825 fix: update identifier to unicode 16 (@JLHwung)
• babel-traverse
  • #16814 fix: issue with node path keys updated on unrelated paths (@DylanPiercey)
• babel-plugin-transform-classes
  • #16797 Use an inclusion rather than exclusion list for super() check (@nicolo-ribaudo)
• babel-generator
  • #16788 Fix printing of TS infer in compact mode (@nicolo-ribaudo)
  • #16785 Print TS type annotations for destructuring in assignment pattern (@nicolo-ribaudo)
  • #16778 Respect [no LineTerminator here] after nodes (@nicolo-ribaudo)

:nail_care: Polish

• babel-types
  • #16852 Add deprecated JSDOC for fields (@liuxingbaoyu)

:house: Internal

• babel-core
  • #16820 Allow sync loading of ESM when --experimental-require-module (@nicolo-ribaudo)
• babel-helper-compilation-targets, babel-helper-plugin-utils, babel-preset-env
  • #16858 Add browserslist config to external dependency (@JLHwung)
• babel-plugin-proposal-destructuring-private, babel-plugin-syntax-decimal, babel-plugin-syntax-import-reflection, babel-standalone
  • #16809 Archive syntax-import-reflection and syntax-decimal (@nicolo-ribaudo)
• babel-generator
  • #16779 Simplify logic for [no LineTerminator here] before nodes (@nicolo-ribaudo)

:running_woman: Performance

• babel-plugin-transform-typescript
  • #16875 perf: Avoid extra cloning of namespaces (@liuxingbaoyu)
• babel-types
  • #16842 perf: Improve @babel/types builders (@liuxingbaoyu)
  • #16828 Only access BABEL_TYPES_8_BREAKING at startup (@nicolo-ribaudo)