How koajs/koa works
Koa is a small Node.js HTTP middleware framework. A Node HTTP request enters the Application callback, which creates a per-request Context, runs the registered middleware stack, then writes the resulting response. Context exposes request and response APIs; the Request API includes URL/query parsing and content negotiation, while the Response API handles status, headers, body metadata, redirects, and streams. Source excerpts support the core dispatch and response flow; broader request/response capabilities are retained from the README and source index, with uncertain internal links omitted.
Main entry points: application.js Application · context.js Request context · response.js Response API · request.js Request API
Components 11
HTTP runtime
- Application
lib/application.js - Middleware stack
lib/application.js
Request and context APIs
- Request context
lib/context.js - Request API
lib/request.js - Query parameters
lib/search-params.js
Response handling
- Response API
lib/response.js
Shared helpers
- Stream detection
lib/is-stream.js - Field filtering
lib/only.js
Other components
- HTTP client
- Node HTTP server
- HTTP response
Connections 16
- HTTP client → Node HTTP server: sends request
Readme.md - Node HTTP server → Application: dispatches request
Readme.md - Application → Node HTTP server: creates server
lib/application.js - Application → Middleware stack: composes stack
lib/application.js - Application → Request context: creates context
lib/application.js - Middleware stack → Request context: receives context
Readme.md - Request context → Request API: exposes request
Readme.md - Request context → Response API: exposes response
Readme.md - Request API → Query parameters: parses query
lib/request.js - Request context → Response API: delegates methods
lib/context.js - Application → HTTP response: writes response
lib/application.js - Response API → HTTP response: sets headers and body
Readme.md - Application → Stream detection: detects streams
lib/application.js - Application → Field filtering: filters JSON fields
lib/application.js - Request API → Field filtering: filters JSON fields
lib/request.js - Response API → Stream detection: checks stream body
lib/response.js