@babel/plugin-syntax-top-level-await

NOTE: This plugin is included in @babel/preset-env, in ES2022.

Syntax only

This plugin only enables parsing of this feature. Babel doesn't support transforming top-level await, but you can use Rollup's experimentalTopLevelAwait or webpack@5's experiments.topLevelAwait options.

tip

You can safely remove this plugin from your Babel config if using @babel/core 7.15.0 or above.

JavaScript

const val = await promise;

export { val };

Installation

npm

npm install --save-dev @babel/plugin-syntax-top-level-await

Yarn

yarn add --dev @babel/plugin-syntax-top-level-await

Usage

With a configuration file (Recommended)

babel.config.json

{
  "plugins": ["@babel/plugin-syntax-top-level-await"]
}

Via CLI

Shell

babel --plugins @babel/plugin-syntax-top-level-await script.js

Via Node API

JavaScript

require("@babel/core").transformSync(code, {
  plugins: ["@babel/plugin-syntax-top-level-await"],
});