athea

Repositories Projects Packages

koa-static (5.0.0)

Published 2026-02-24 13:59:34 +00:00 by atheaadmin

Installation

Setup this registry in your project .npmrc file:

registry=

To install the package using npm, run the following command:

npm install koa-static@5.0.0

or add it to the package.json file:

"koa-static": "5.0.0"

For more information on the npm registry, see the documentation.

About this package

koa-static

Koa static file serving middleware, wrapper for koa-send.

Installation

$ npm install koa-static

API

const Koa = require('koa');
const app = new Koa();
app.use(require('koa-static')(root, opts));

• root root directory string. nothing above this root directory can be served
• opts options object.

Options

• maxage Browser cache max-age in milliseconds. defaults to 0
• hidden Allow transfer of hidden files. defaults to false
• index Default file name, defaults to 'index.html'
• defer If true, serves after return next(), allowing any downstream middleware to respond first.
• gzip Try to serve the gzipped version of a file automatically when gzip is supported by a client and if the requested file with .gz extension exists. defaults to true.
• br Try to serve the brotli version of a file automatically when brotli is supported by a client and if the requested file with .br extension exists (note, that brotli is only accepted over https). defaults to true.
• setHeaders Function to set custom headers on response.
• extensions Try to match extensions from passed array to search for file when no extension is sufficed in URL. First found is served. (defaults to false)

Example

const serve = require('koa-static');
const Koa = require('koa');
const app = new Koa();

// $ GET /package.json
app.use(serve('.'));

// $ GET /hello.txt
app.use(serve('test/fixtures'));

// or use absolute paths
app.use(serve(__dirname + '/test/fixtures'));

app.listen(3000);

console.log('listening on port 3000');

See also

• koajs/conditional-get Conditional GET support for koa
• koajs/compress Compress middleware for koa
• koajs/mount Mount koa-static to a specific path

License

MIT

Dependencies

Dependencies

ID	Version
debug	^3.1.0
koa-send	^5.0.0

Development Dependencies

ID	Version
eslint	^4.19.1
eslint-config-standard	^11.0.0
eslint-plugin-import	^2.12.0
eslint-plugin-node	^6.0.1
eslint-plugin-promise	^3.8.0
eslint-plugin-standard	^3.1.0
istanbul	^0.4.5
koa	^2.5.1
mocha	^5.2.0
supertest	^3.1.0

Keywords

koa middleware file static sendfile

Details

npm

2026-02-24 13:59:34 +00:00

0

Project Site

MIT

latest

3.0 KiB

Assets (1)

koa-static-5.0.0.tgz 3.0 KiB

Versions (1) View all

5.0.0 2026-02-24