unicorn/prefer-top-level-await Pedantic

What it does

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

Why is this bad?

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

Examples

Examples of incorrect code for this rule:

(async () => {
    await run();
})();

run().catch(error => {
    console.error(error);
});

Examples of correct code for this rule:

await run();

try {
    await run();
} catch (error) {
    console.error(error);
}

How to use

To enable this rule using the config file or in the CLI, you can use:

Config (.oxlintrc.json)

{
    "rules": {
        "unicorn/prefer-top-level-await": "error"
    }
}

CLI

oxlint --deny unicorn/prefer-top-level-await

References

• Rule Source