Koa.js
A minimalist Node.js framework built on async middleware
js web framework created by the original Express team that uses async functions and a middleware cascade (via the 'onion model') to eliminate callback nesting and give developers fine-grained control over the request/response cycle.
Definition
Koa.js is a minimalist Node.js web framework created by the original Express team that uses async functions and a middleware cascade (via the 'onion model') to eliminate callback nesting and give developers fine-grained control over the request/response cycle.
Overview
Koa was released in 2013 by TJ Holowaychuk and the Express core team as a ground-up rethink of what a minimal Node.js framework should look like once generators and later async/await became available in JavaScript. Where Express relies on a linear middleware chain and callback-based error handling, Koa restructures middleware into a single 'onion model': each middleware function wraps around the next, executing code both before and after calling `await next()`. This lets a single middleware function handle logic both upstream and downstream of the rest of the stack, such as measuring total request time or catching errors thrown anywhere further down the chain with ordinary try/catch. Koa deliberately ships without a built-in router, templating engine, or bundled middleware — even body parsing is not included by default. This is a philosophical choice: the framework provides only a small core (context, request, response objects, and the middleware cascade), leaving developers to compose exactly the pieces they need from the ecosystem, such as `@koa/router` for routing or `koa-bodyparser` for parsing request bodies. This makes Koa lighter and more flexible than fuller-featured frameworks, but requires more manual assembly for a production-ready application. Koa's `ctx` (context) object unifies the request and response into a single object with convenient getters and setters, reducing boilerplate compared to Node's raw `req`/`res`. Error handling is centralized: because middleware execution is just a chain of awaited async functions, a single top-level try/catch middleware can capture errors from anywhere in the pipeline, which was notably harder to do cleanly with Express's callback-oriented middleware. Koa is popular among developers who want Express's simplicity with a cleaner async model and are comfortable choosing their own routing, validation, and body-parsing libraries.
Key Features
- Async/await-based middleware cascade (the 'onion model') instead of linear callback chains
- No bundled router, body parser, or template engine — fully composable via middleware
- Unified ctx object combining request and response with convenient accessors
- Centralized, try/catch-friendly error handling across the whole middleware stack
- Small core codebase, keeping the framework itself lightweight
- Created by the original Express team as a spiritual successor
- Strong ecosystem of Koa-specific middleware (@koa/router, koa-bodyparser, koa-compress)