Skip to content
  • Home
  • About
  • No Access
  • Privacy Policy
Bits of .NET
Bits of .NET
  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy

Bits of .NET

Daily micro-tips for C#, SQL, performance, and scalable backend engineering.

  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy
JavaScript

JavaScript: Use Top-Level Await in Modules for Cleaner Async Code

- 28.05.26 | 28.05.26 - ErcanOPAK

⏰ Async Without Async Function Wrapper

Need await at top level? Used to need IIFE.
Top-level await
works directly in ES modules. Cleaner initialization code.

❌ Old Way (IIFE)

(async () => {
  const data = await fetch('/api/config');
  const config = await data.json();
  startApp(config);
})();
        

✅ Top-Level Await

// In .mjs or type="module" script
const response = await fetch('/api/config');
const config = await response.json();

startApp(config);
        

🎯 Real-World Examples

// Database connection (Node.js)
import { createConnection } from 'mysql2/promise';

const db = await createConnection({
  host: 'localhost',
  user: 'root',
  database: 'myapp'
});

export { db };


// Dynamic imports
const math = await import('./math.js');

console.log(math.add(2, 3));


// Reading files (Node.js)
import { readFile } from 'fs/promises';

const packageJson = JSON.parse(
  await readFile('./package.json', 'utf-8')
);

export const version = packageJson.version;


// API initialization
const users = await fetch('/api/users')
  .then(r => r.json());

const products = await fetch('/api/products')
  .then(r => r.json());

export { users, products };
    

✅ Important Notes

  • Only works in ES modules
    (type="module")
  • Top-level await blocks module evaluation
  • Importing modules with top-level await → import waits
  • Useful for module initialization that needs async

💡 Use Cases

  • Loading configuration before app starts
  • Database connection in Node.js modules
  • Dynamic imports based on conditions
  • Reading environment-dependent resources
  • Initializing SDKs that need async setup

“Every API module started with async IIFE.
Top-level await removed wrapper.
Code cleaner, startup logic obvious.
ES modules are finally complete.”

— JavaScript Developer

Related posts:

Debounce vs Throttle — The UI Performance Problem Everyone Gets Wrong

Debounce vs Throttle — The UI Performance Problem Everyone Gets Wrong

JavaScript: Fix Optional Chaining Silently Hiding a Typo in a Property Name Instead of Throwing Wher...

JavaScript: Fix Optional Chaining Silently Hiding a Typo in a Property Name Instead of Throwing Wher...

Throttle Requests to Save Backend

Throttle Requests to Save Backend

Views: 20

Post navigation

HTML: Use Native Dialog Element for Modals Without JavaScript Libraries
Ajax: Use FormData API for File Uploads Without Libraries

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

November 2026
M T W T F S S
 1
2345678
9101112131415
16171819202122
23242526272829
30  
« Oct    

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (977)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (854)
  • How to enable, disable and check if Service Broker is enabled on a database in SQL Server (653)
  • Add Constraint to SQL Table to ensure email contains @ (609)
  • Average of all values in a column that are not zero in SQL (570)
  • How to use Map Mode for Vertical Scroll Mode in Visual Studio (547)
  • Find numbers with more than two decimal places in SQL (475)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit
  • SQL Server: Fix ROW_NUMBER Ties Reordering Between Identical Runs
  • C#: Fix an Enum HasFlag Returning True for the Zero Value
  • WordPress: Fix Featured Images Vanishing After a CDN Migration
  • Photoshop: Fix Content-Aware Fill Smearing a Repeating Pattern
  • Asp.Net Core: Fix Antiforgery Tokens Rejected Behind a Reverse Proxy

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (977)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (854)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit

Social

  • ErcanOPAK.com
  • GoodReads
  • LetterBoxD
  • Linkedin
  • The Blog
  • Twitter
© 2026 Bits of .NET | Built with Xblog Plus free WordPress theme by wpthemespace.com