Skip to main content

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

info

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

note

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 install --save-dev @babel/plugin-syntax-top-level-await

Usage

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"],
});