How Promise.all Works in a Single-Threaded JavaScript World

How Promise.all Works in a Single-Threaded JavaScript World

If JavaScript is single-threaded, how can Promise.all() handle multiple requests at the same time?

The short answer:

JavaScript is single-threaded for executing code, but I/O is handled outside the JS thread.

🧠 What “single-threaded” really means#

• Only one piece of JavaScript runs at a time.
• JS does NOT block while waiting for network, timers, or disk.

⚙️ Step-by-step: What happens with Promise.all#

await Promise.all([
  fetch("/a"),
  fetch("/b"),
  fetch("/c"),
]);

1️⃣ Requests start immediately#

const p1 = fetch("/a");
const p2 = fetch("/b");
const p3 = fetch("/c");

• Promises are created instantly.
• Network work starts in the background.
• JS thread is free.

2️⃣ Network runs outside JS#

• Browser or Node runtime handles requests.
• Requests run concurrently.
• JS thread does nothing during this time.

3️⃣ Promise resolution uses microtasks#

• When a request finishes, its Promise resolves.
• .then() callbacks go to the microtask queue.
• JS executes them one by one.

4️⃣ Promise.all resolves last#

• Waits for all Promises to resolve.
• Rejects early if one fails.

🔄 Timeline#

🧠 Mental Model#

• JS thread = single chef
• Network = multiple delivery drivers
• Promise.all = wait for all deliveries

⚠️ Important note#

Promise.all() does NOT make CPU work parallel.

Promise.all([
  heavyTask(),
  heavyTask(),
]);

This still blocks the UI.

🧱 Browser vs Node#

✅ Summary#

✨ Final takeaway#

JS coordinates work — it doesn’t do it all itself.
Promise.all works because the heavy work happens outside the JS thread.