prefer-top-level-await.md

prefer-top-level-await

📝 Prefer top-level await over top-level promises and async function calls.

💼 This rule is enabled in the following configs: ✅ recommended, ☑️ unopinionated.

💡 This rule is manually fixable by editor suggestions.

Top-level await is more readable and can prevent unhandled rejections.

Examples

// ❌
(async () => {
	try {
		await run();
	} catch (error) {
		console.error(error);
		process.exit(1);
	}
})();

// ❌
async function main() {
	try {
		await run();
	} catch (error) {
		console.error(error);
		process.exit(1);
	}
}

main();

// ✅
try {
	await run();
} catch (error) {
	console.error(error);
	process.exit(1);
}

// ❌
run().catch(error => {
	console.error(error);
	process.exit(1);
});

// ✅
await run();

Initializing a variable directly with a top-level promise for later awaiting is allowed:

// ✅
const preparationDone = prepareSomething();

export async function doSomething() {
	await preparationDone;
}