babel-plugin-transform-regenerator

babel-plugin-transform-regenerator

Transform async/generator functions with regenerator

Example

In

function* a() {
  yield 1;
}

Out

var _marked = [a].map(regeneratorRuntime.mark);

function a() {
  return regeneratorRuntime.wrap(function a$(_context) {
    while (1) {
      switch (_context.prev = _context.next) {
        case 0:
          _context.next = 2;
          return 1;

        case 2:
        case "end":
          return _context.stop();
      }
    }
  }, _marked[0], this);
}

Installation

npm install --save-dev babel-plugin-transform-regenerator

Usage

Via .babelrc (Recommended)

Without options:

{
  "plugins": ["transform-regenerator"]
}

With options:

name	default value
asyncGenerators	true
generators	true
async	true

{
  "plugins": [
    ["transform-regenerator", {
      "asyncGenerators": false,
      "generators": false,
      "async": false
    }]
  ]
}

Via CLI

babel --plugins transform-regenerator script.js

Via Node API

require("babel-core").transform("code", {
  plugins: ["transform-regenerator"]
});

Similar packages

Other packages similar to babel-plugin-transform-regenerator

@babel/plugin-transform-async-to-generator

This package transforms async functions into generator functions, similar to how babel-plugin-transform-regenerator handles async/await syntax. However, it is specifically focused on the async/await syntax rather than on generator functions in general.

regenerator-runtime

While not a Babel plugin, regenerator-runtime is often used in conjunction with babel-plugin-transform-regenerator to provide a runtime environment for the transformed generator functions. It includes a polyfill for the regenerator runtime, which is necessary for the transpiled generator functions to work.