koa-range-static

Static file server middleware, support for multipart ranges request

Install

1npm i koa-range-static

Example

1const Application = require("koa");
2const { rangeStatic } = require("koa-range-static");
3
4const app = new Application();
5app.use(rangeStatic({ root: ".", directory: true }));
6app.listen(3000);

API

1// rangeStatic
2const { rangeStatic } = require("koa-range-static");
3app.use(rangeStatic(rangeStaticOptions));
4
5// send
6const { send } = require("koa-range-static");
7app.use(async (ctx) => {
8  await send(ctx, ctx.path, sendOptions);
9});

• rangeStatic options

  • directory Show directory, conflict with format. Default is false
  • renderDirent Render directory entries.
  • For others, see send options

• send options

  • delay Delay sending each chunk. Default is 0
  • format If not false, format the path to serve static file servers and not require a trailing slash for directories, so that you can do both /directory and /directory/. Default is false
  • hidden Allow transfer of hidden files and show hidden directory. Default is false
  • immutable Tell the browser the resource is immutable and can be cached indefinitely. Default is false
  • index Name of the index file to serve automatically when visiting the root location. Default is "index.html"
  • maxage Browser cache max-age in seconds. Default is 0
  • multipart Enable multipart ranges. Default is true
  • root Root directory to restrict file access. Default is resolve()
  • getBoundaryParam Boundary parameter required for multipart ranges requests. Default is a random value of length 12

License

MIT