0.8.18 • Published 2 years ago

babel-plugin-transform-async-to-promises v0.8.18

Weekly downloads
164,248
License
MIT
Repository
github
Last release
2 years ago

babel-plugin-transform-async-to-promises

Babel plugin to transform async functions containing await expressions to the equivalent chain of Promise calls with use of minimal helper functions.

Input:

async function fetchAsObjectURL(url) {
    const response = await fetch(url);
    const blob = await response.blob();
    return URL.createObjectURL(blob);
}

Output:

const fetchAsObjectURL = _async(function(url) {
	return _await(fetch(url), function(response) {
		return _await(response.blob(), URL.createObjectURL);
	});
});

Output with hoist enabled:

function _response$blob(response) {
	return _await(response.blob(), URL.createObjectURL);
}
const fetchAsObjectURL = _async(function(url) {
	return _await(fetch(url), _response$blob);
});

Output with inlineHelpers enabled:

const fetchAsObjectURL = function(url) {
	try {
		return Promise.resolve(fetch(url)).then(function(response) {
			return Promise.resolve(response.blob()).then(URL.createObjectURL);
		});
	} catch(e) {
		return Promise.reject(e);
	}
}

Output with externalHelpers enabled:

In the normal case, helpers are added to the top of the file for the _async and _await functions (as well as others). This can cause bloat in a codebase due to duplication of helper code in every file. To avoid this, enable externalHelpers and those will be imported instead:

import { _async } from "babel-plugin-transform-async-to-promises/helpers";
import { _await } from "babel-plugin-transform-async-to-promises/helpers";

const fetchAsObjectURL = _async(function(url) {
	return _await(fetch(url), function(response) {
		return _await(response.blob(), URL.createObjectURL);
	});
});

export default fetchAsObjectURL;

JavaScript Language Features

Full Support

  • async/await
  • for/while/do loops (including loops that would exhaust stack if dispatched recursively)
  • switch statements (including fallthrough and default cases)
  • conditional expressions
  • logical expressions
  • try/catch
  • break/continue statements (on both loops and labeled statements)
  • throw expressions
  • Function hoisting
  • Variable hoisting
  • Arrow functions
  • Methods
  • arguments
  • this
  • Proper member dereference order of operations
  • Standards-compliant event loop scheduling

Partial Support

  • Function.length: async functions will often return a length of 0 (when the _async wrapper is used)
  • Top level await support is experimental with compatible module bundler. Set topLevelAwait option to return when using SystemJS.

No support

  • eval: impossible to support without deep hooks into the runtime
  • Async generator functions: not implemented or planned
  • Function.name: rewrite pass removes function name instrumentation
  • new AsyncFunction(...): impossible to support without shipping babel and the plugin in the output
@knapsack/babel-config-starter@knapsack/babel-config@jvdx/babel@jvdx/babel-preset-jvdxtsdx-extraproject-name-herecloud-archive-s3@codewitchbella/microbundletakla-buildertakla-builder-presets@cyca/babel-presets@saaspe/componentsfe-cli-script@everything-registry/sub-chunk-1204p149-table@ttungbmt/bundlers.rollup@ttungbmt/microbundle-crlaxonv2sdk@ambroseus/tsdxbabel-preset-minimal@aristidenf/streak-counter@akinoxsolutions/microbundlebili@alexandernanberg/bricks@backslashbuild/microbundle@datagraphics/baker@bscswap/binance-connectorbuilderz@bung87/bilipkgerreact-lightbox-pack-18supportp147-tablep148-tabletsdx-with-svgui5-tooling-transpiletranzpiletzcc-lg-v1webchewillow-build-toolszero-bundlerzlcshikakastyledbuttonxxsuntmolestiaesource-map-to-codestep-interpreterresponsis-gantt-task-reactresponsive-react-approllup-workerrollup-toolkitrollup-configuredtemporaetray-pack-toolkit@chialab/babel-preset@cpro-js/vite-ui5-integration-plugincotrader-dex-sdk@anst/babel-config@heatmanofurioso/microbundle@hasparus/microbundleanything-config-fisker@1stg/babel-preset@infinitebrahmanuniverse/nolb-babel-plugin-t@iosio/rollup-plugin-custom-x-babeldoloribusseddataorm@eik/microbundle@ff0000-ad-tech/wp-deploy-manager@fishx/stark@devorso/dcountdown@datadesk/baker@graines-digitales/nice-handsome-button@jsenv/plugin-transpilation@jsenv/babel-config-map@jsenv/babel-plugin-description@jsenv/babel-plugin-map@jsenv/babel-plugins@jsenv/babel-preset@jsenv/js-module-fallback@jvdx/babel-preset@klutch-card/klutch-cli@kne/microbundle@leiyulf/gantt-task-react@jarrku/foreach-tsdx@m-fe/babel-preset@micro-web/microbundle@maujzs/branch-releasegetvoip_renderer@nore/bundle-js@nore/plugin-js@n3tr/tsdx@kommunicate/kommunicate-chatbot-plugin@lotus-ui/angela@nx-custom/rollup@nx/rollup@inti-ar/evm-chains@projectbabelfish/defikingdoms-sdk@pansy/cli@paljs/create@probablyup/microbundle@qp-mongosh/async-rewriter2
0.8.18

2 years ago

0.8.17

2 years ago

0.8.16

2 years ago

0.8.15

4 years ago

0.8.14

5 years ago

0.8.13

5 years ago

0.8.12

5 years ago

0.8.11

5 years ago

0.8.10

5 years ago

0.8.9

5 years ago

0.8.8

5 years ago

0.8.7

5 years ago

0.8.6

5 years ago

0.8.5

5 years ago

0.8.4

5 years ago

0.8.3

5 years ago

0.8.2

5 years ago

0.8.1

5 years ago

0.8.0

5 years ago

0.7.2

5 years ago

0.7.1

6 years ago

0.7.0

6 years ago

0.6.1

6 years ago

0.6.0

6 years ago

0.5.7

6 years ago

0.5.6

6 years ago

0.5.5

6 years ago

0.5.4

6 years ago

0.5.3

6 years ago

0.5.2

6 years ago

0.5.1

6 years ago

0.5.0

6 years ago

0.4.0

6 years ago

0.3.0

6 years ago

0.2.0

6 years ago

0.1.0

6 years ago