open atlas
↑ Back to track
JavaScript Engine internals JSE · 07 · 01

The engine vs the loop

The engine has no event loop — the host (browser, Node via libuv) owns it. What the engine provides is the microtask queue and one operation: PerformMicrotaskCheckpoint. The host runs a task; on return the engine drains microtasks.

JSE Middle ◷ 12 min
Level
FoundationsJuniorMiddleSenior

You have read a dozen times that “JavaScript has an event loop.” Then you open the V8 source and grep for it — and there is no event loop in there. There is a parser, an interpreter, optimising compilers, a garbage collector, and a queue of pending jobs. The loop that famously schedules your callbacks lives somewhere else entirely: in Chromium’s message loop, in Node’s libuv. The engine and the loop are two different programs.

The engine does not have an event loop

The browser overview lessons treat the event loop as one machine — browser/01-event-loop/01-loop-model is the runtime view. This unit is the engine view, and the first correction is structural: the engine has no event loop. ECMAScript, the language V8 implements, never mentions one. The spec defines jobs and a job queue, and it says hosts must eventually run queued jobs — but the algorithm that decides when and which task to run next is explicitly left to the host (via the HOST hooks HostEnqueuePromiseJob, HostCallJobCallback).

So the division of labour is:

  • The host (Chromium’s message loop, Node plus libuv, Deno, Bun) owns the loop. It holds the macrotask queues (timers, I/O completions, message events), it decides which task runs next, and it drives rendering. It is the while (true) at the top.
  • The engine (V8) owns one queue — the microtask queue (the ECMAScript “jobs queue”) — and exposes one operation to drain it: PerformMicrotaskCheckpoint. It runs the JavaScript the host hands it, to completion, and on the way out it drains its own microtasks.

Together, host and engine interlock so precisely that async ordering stops feeling like folklore and starts feeling inevitable — get this split clear once and every subsequent async surprise has a mechanical explanation.

When people say “the event loop,” they mean the host loop. When they say “microtasks run after the current task,” they mean the engine’s checkpoint. Conflating the two is why async ordering feels like folklore instead of mechanism.

The shape of one turn: host calls in, engine returns, microtasks drain

A single turn of the host loop is a call into the engine and a return out of it. The host picks one macrotask (say, a fired click event or an expired timer), and calls into the engine on the associated JavaScript callback. The engine pushes a stack frame, runs your code to completion — JavaScript is run-to-completion, there is no pre-emption mid-function — and when the call stack empties, the engine performs a microtask checkpoint: it drains every queued microtask (Promise reactions, queueMicrotask jobs) until the queue is empty, including microtasks that other microtasks enqueued. Only then does control return to the host, which renders (in the browser) and picks the next macrotask.

The crucial detail: the microtask drain happens inside the single host-to-engine call, before the engine returns. From the host’s point of view, running the click handler and running every promise reaction it scheduled is one indivisible task. That is why microtasks always run before the next timer, before the next render, before the next anything: they are not a separate task the host schedules — they are the tail of the task that is already running.

Who provides the checkpoint, and who calls it

PerformMicrotaskCheckpoint is V8’s; the decision to call it is partly shared. V8 will auto-run microtasks when the JS call stack empties (the default “auto” microtask policy used by the browser). Node uses an explicit policy: libuv runs a phase, and Node calls runMicrotasks() itself at well-defined points (after each macrotask callback, and between phases) — which is why Node’s ordering has its own rules we cover next lesson. Either way, the queue and the drain are the engine’s; the cadence is the host’s.

Who owns what in 'the event loop'
The while-loop / task selection
host
Macrotask queues (timers, I/O)
host
Rendering steps
host (browser)
Microtask queue (jobs queue)
engine
PerformMicrotaskCheckpoint
engine
When the checkpoint fires
host policy

Run-to-completion is the load-bearing rule

Everything above rests on one engine guarantee: run-to-completion. Once the host hands the engine a callback, that callback runs start-to-finish with no other JavaScript interleaving. No second task, no microtask, nothing pre-empts it. This is what makes a for loop atomic from the program’s view and what makes await (next lessons) need an explicit suspension mechanism — the engine cannot just “pause” a function the way an OS pauses a thread, because run-to-completion forbids it. The function must return to the host, and a microtask must resume it later.

Quiz

You grep the V8 source and find no event loop. Where does the loop that schedules your `setTimeout` callbacks actually live?

Quiz

From the host's perspective, running a click handler plus every promise reaction it schedules counts as how many tasks?

Order the steps

Order what happens in one turn of the browser's host loop, starting from an expired timer, ending just before the next task is picked.

  1. 1 Host picks the timer macrotask and calls into the engine
  2. 2 Engine runs the timer callback to completion (run-to-completion)
  3. 3 Engine performs the microtask checkpoint, draining all queued microtasks
  4. 4 Engine returns control to the host with the stack empty
  5. 5 Host runs the rendering steps, then loops back to pick the next task
Why this works

Why split it this way at all? Because one engine (V8) must serve hosts with wildly different loops — a browser that must render at 60 fps, a server that must not render at all and instead juggles thousands of sockets through libuv. Putting the loop in the host lets each host schedule for its own world while reusing one language core. The engine’s contract is narrow on purpose: “give me a callback, I run it to completion and drain my jobs, then I hand you back the thread.”

Recall before you leave
  1. 01
    Precisely divide responsibilities between the engine and the host for 'the event loop'.
  2. 02
    Why do microtasks always run before the next macrotask and before rendering, with no exceptions in the browser?
  3. 03
    Run-to-completion forbids the engine from pausing a function mid-execution. What consequence does that have for async/await?
Recap

“JavaScript has an event loop” is a useful lie that hides the real architecture. The engine — V8 — has no loop; it implements the ECMAScript language, owns the microtask (jobs) queue, and exposes one operation, PerformMicrotaskCheckpoint, to drain it. The loop lives in the host: Chromium’s message loop in the browser, libuv in Node. One turn of that loop is a call into the engine and a return out of it — the host picks a macrotask, the engine runs it to completion (run-to-completion, no pre-emption), the engine drains its microtask queue including any microtasks scheduled during the drain, and only then returns, after which the browser host renders and picks the next task. The microtask drain happens inside that single call, which is why microtasks are the tail of the current task rather than a new one. The browser uses V8’s automatic microtask policy; Node uses an explicit policy where libuv and Node decide the cadence — the queue is still the engine’s, the timing is the host’s. Now when you see a microtask run “too early” or a render that never fires, you know exactly which layer to look at — the engine’s checkpoint, or the host’s loop.

Practice

Start at the top. Tasks go easiest → hardest: recall a fact, apply it to a case, then a senior-level stretch. Open one, attempt it, then reveal.

recallapplystretch0 of 5 done
Connected lessons
appears again in184

Something unclear?

Ask a question about this lesson. Questions are anonymous and go straight to the author to make the lesson better.

shortcuts expand
search
K
prev piece
k
next piece
j
cycle tier
t
this menu
?
sources3
expand
  1. 01
  2. 02
  3. 03

Trademarks belong to their respective owners. Editorial reference only.