koa-static
Koa-servlet is a wrapper for koa-send
which allows to serve a given file path from a given root
.
Installation
$ npm install koa-servlet
API
const Koa = ;const app = ;app;
servlets
is aMap
of paths androots
.opts
options object, which reflects tokoa-send
options.
Options
maxage
Browser cache max-age in milliseconds. defaults to 0hidden
Allow transfer of hidden files. defaults to falseindex
Default file name, defaults to 'index.html'defer
If true, serves afterreturn 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 tofalse
)
Example
const serve = ;const Koa = ;const app = ; // $ GET /robots.txt const servlets = '/robots.txt' __dirname + '/test/fixtures/robots.txt'; // or use absolute pathsapp; app; console;
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