Promise chaining in Node.js - Performance & Optimization

Performance: Promise chaining

MEDIUM IMPACT

Promise chaining affects the responsiveness and smoothness of asynchronous operations in the browser or Node.js event loop.

Executing multiple asynchronous tasks in sequence

Node.js

doTask1()
  .then(() => doTask2())
  .then(() => doTask3())
  .then(() => {
    console.log('All done');
  });

Flat promise chain improves readability and allows microtasks to be processed efficiently.

📈 Performance GainReduces microtask queue complexity and improves INP by avoiding nested callbacks

Executing multiple asynchronous tasks in sequence

Node.js

doTask1().then(() => {
  return doTask2().then(() => {
    return doTask3().then(() => {
      console.log('All done');
    });
  });
});

Nested .then calls create callback hell, making code harder to read and maintain, and can cause microtask queue delays.

📉 Performance CostBlocks event loop longer due to nested microtasks and harder error handling

Performance Comparison

Pattern	Microtask Queue Complexity	Event Loop Blocking	Error Handling	Verdict
Nested .then callbacks	High (deep nesting)	Higher blocking due to nested microtasks	Harder to catch errors	[X] Bad
Flat promise chaining	Low (linear chain)	Minimal blocking, smoother event loop	Simpler error propagation	[OK] Good

Rendering Pipeline

Promise chaining schedules microtasks that run after the current script but before rendering. Proper chaining avoids blocking the event loop and allows the browser or Node.js to process UI updates and user input smoothly.

→JavaScript Execution

→Microtask Queue

→Event Loop

⚠️ BottleneckMicrotask Queue can become congested if promises are nested deeply or chained inefficiently.

Core Web Vital Affected

INP

Promise chaining affects the responsiveness and smoothness of asynchronous operations in the browser or Node.js event loop.

Optimization Tips

1Avoid nesting .then callbacks; chain promises flatly.

2Keep promise chains short and linear to reduce microtask queue congestion.

3Handle errors at the end of the chain to avoid blocking the event loop.

Performance Quiz - 3 Questions

What is a performance benefit of flat promise chaining over nested .then callbacks?

A Reduces microtask queue complexity and improves responsiveness

B Increases bundle size significantly

C Blocks rendering longer to ensure order

D Makes error handling impossible

DevTools: Performance

How to check: Record a performance profile while running your asynchronous code. Look at the 'Microtasks' section and check for long or nested microtask execution times.

What to look for: Short, linear microtask chains indicate good promise chaining. Long nested microtasks or gaps in responsiveness indicate poor chaining.

Practice

1. What is the main purpose of promise chaining in Node.js?

easy

A. To convert synchronous code into asynchronous code

B. To run all asynchronous tasks at the same time

C. To run asynchronous tasks one after another in order

D. To stop all asynchronous tasks immediately

Solution

1. Step 1: Understand asynchronous task execution

   Promise chaining allows tasks to run one after another, waiting for each to finish.

2. Step 2: Identify the purpose of chaining

   Chaining with .then() ensures order, not parallel or immediate stop.

3. Final Answer:

   To run asynchronous tasks one after another in order -> Option C

4. Quick Check:

   Promise chaining = ordered async tasks [OK]

Hint: Promise chaining runs tasks step-by-step, not all at once [OK]

Common Mistakes:

• Thinking promises run in parallel by default
• Confusing chaining with synchronous loops
• Believing chaining stops tasks immediately

2. Which of the following is the correct syntax to chain two promises promise1 and promise2?

easy

A. promise1.then(promise2)

B. promise1.then(promise2())

C. promise1.then.then(promise2)

D. promise1.then(() => promise2())

Solution

1. Step 1: Understand how to pass functions to .then()

   The .then() method expects a function to call when the promise resolves.

2. Step 2: Check each option's syntax

   promise1.then(() => promise2()) correctly passes a function that calls promise2(). Options A and B call promise2() immediately or pass wrong types. promise1.then.then(promise2) has invalid chaining syntax.

3. Final Answer:

   promise1.then(() => promise2()) -> Option D

4. Quick Check:

   Pass a function to then() = promise1.then(() => promise2()) [OK]

Hint: Use a function inside then() to delay calling next promise [OK]

Common Mistakes:

• Calling the next promise immediately inside then()
• Using double then without parentheses
• Passing promise instead of function to then()

3. What will be logged to the console when running this code?

Promise.resolve(5)
  .then(x => x + 1)
  .then(x => { throw new Error('Fail'); })
  .catch(err => 'Caught: ' + err.message)
  .then(x => console.log(x));

medium

A. Caught: Fail

B. Fail

C. 6

D. undefined

Solution

1. Step 1: Follow the promise chain step-by-step

   The first then adds 1 to 5, resulting in 6. The second then throws an error.

2. Step 2: Understand error handling and final output

   The catch catches the error and returns the string 'Caught: Fail'. The last then logs this string.

3. Final Answer:

   Caught: Fail -> Option A

4. Quick Check:

   Error caught and message logged = Caught: Fail [OK]

Hint: Errors jump to catch, then continue chain with catch result [OK]

Common Mistakes:

• Expecting error to stop all logging
• Thinking catch returns undefined
• Ignoring that catch returns a value to next then

4. Identify the error in this promise chain:

fetchData()
  .then(data => processData(data))
  .then(result => console.log(result))
  .catch(console.error())

medium

A. Missing return in first then

B. Incorrect use of catch with immediate function call

C. processData is not a function

D. console.log should be inside catch

Solution

1. Step 1: Check the catch usage

   The catch method expects a function reference, but console.error() calls the function immediately, passing its result (undefined) instead.

2. Step 2: Correct catch usage

   It should be .catch(console.error) without parentheses to pass the function itself.

3. Final Answer:

   Incorrect use of catch with immediate function call -> Option B

4. Quick Check:

   Pass function to catch, not call it immediately [OK]

Hint: Pass function to catch, don't call it with () [OK]

Common Mistakes:

• Calling catch handler immediately instead of passing function
• Forgetting to return promises inside then
• Misplacing console.log inside catch

5. Given these functions:

function step1() { return Promise.resolve(2); }
function step2(x) { return Promise.resolve(x * 3); }
function step3(x) { return x + 4; }

What will this code log?

step1()
  .then(x => step2(x))
  .then(x => step3(x))
  .then(console.log);

hard

A. 10

B. Promise { 10 }

C. undefined

D. Error: step3 must return a Promise

Solution

1. Step 1: Calculate step1 and step2 results

   step1() resolves to 2. Then step2(2) resolves to 6 (2*3).

2. Step 2: Understand step3 return and final log

   step3(6) returns 10 (6+4) synchronously. Since then accepts a value or promise, it passes 10 to next then which logs 10.

3. Final Answer:

   10 -> Option A

4. Quick Check:

   Sync return in then passes value = 10 [OK]

Hint: then can handle sync values; they become resolved promises [OK]

Common Mistakes:

• Expecting step3 to return a Promise always
• Thinking console.log logs a Promise object
• Confusing synchronous return with Promise return