Testing async code in Node.js - Step-by-Step Execution

Concept Flow - Testing async code

Start Test

↓

Call async function

↓

Wait for Promise to resolve

↓

Check resolved value

↓

Pass

↓

Test Ends

The test calls an async function, waits for its result, then checks if the result matches the expected value to pass or fail.

Execution Sample

Node.js

test('fetch data returns correct value', async () => {
  const data = await fetchData();
  expect(data).toBe('hello');
});

This test waits for fetchData() to finish and checks if it returns 'hello'.

Execution Table

Step	Action	Promise State	Value/Result	Test Status
1	Test starts, calls fetchData()	Pending	No value yet	Running
2	Await fetchData() resolves	Resolved	'hello'	Running
3	Check if data === 'hello'	Resolved	true	Pass
4	Test ends	Resolved	N/A	Pass

💡 Test ends after assertion passes with resolved value 'hello'

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	Final
data	undefined	undefined	'hello'	'hello'	'hello'

Key Moments - 3 Insights

Why do we use 'await' inside the test function?

Because fetchData() returns a Promise, 'await' pauses the test until the Promise resolves, ensuring we check the actual returned value (see execution_table step 2).

What happens if we forget to use 'async' before the test function?

The test won't wait for the Promise to resolve and may finish too early, causing false passes or failures (test status won't reflect the async result).

Why is the test status 'Running' before the Promise resolves?

Because the async function is still waiting for the Promise to finish, so the test is not complete yet (execution_table step 1 and 2).

Visual Quiz - 3 Questions

Look at the execution table, what is the value of 'data' after step 2?

A null

B 'hello'

C undefined

D Promise

💡 Hint

Check the 'Value/Result' column at step 2 in the execution_table.

At which step does the test check the resolved value?

A Step 1

B Step 2

C Step 3

D Step 4

💡 Hint

Look for the step where the condition 'data === "hello"' is evaluated in the execution_table.

If we remove 'await' from the test, what will likely happen?

A Test may finish before Promise resolves

B Test will wait correctly

C Test will fail immediately

D Test will throw a syntax error

💡 Hint

Refer to key_moments about the importance of 'await' in async tests.

Concept Snapshot

Testing async code in Node.js:
- Use 'async' keyword on test function
- Use 'await' to wait for Promise results
- Assert on resolved values
- Ensures tests run only after async work finishes
- Prevents false positives or negatives

Full Transcript

Testing async code means writing tests that wait for asynchronous operations to finish before checking results. In Node.js, this is done by marking the test function as async and using 'await' to pause execution until the Promise resolves. The test then compares the resolved value to the expected result. This prevents tests from ending too early and gives accurate pass/fail results. The execution flow starts with calling the async function, waiting for it to resolve, then asserting the value. Variables like 'data' change from undefined to the resolved value during the test. Forgetting 'await' or 'async' causes the test to behave incorrectly by not waiting for the async operation.