Giter VIP home page Giter VIP logo

koa-files's Introduction

koa-files

A static files serving middleware for koa.

NPM Version Download Status Languages Status Node Version

Installation

$ npm install koa-files

API

import { Middleware } from 'koa';
import { createReadStream, stat, Stats } from 'fs';

interface IgnoreFunction {
  (path: string): boolean;
}

interface Headers {
  [key: string]: string | string[];
}

interface HeaderFunction {
  (path: string, stats: Stats): Headers | void;
}

interface FileSystem {
  readonly stat: typeof stat;
  readonly createReadStream: typeof createReadStream;
}

export interface Options {
  etag?: boolean;
  fs?: FileSystem;
  defer?: boolean;
  acceptRanges?: boolean;
  lastModified?: boolean;
  ignore?: IgnoreFunction;
  headers?: Headers | HeaderFunction;
}

export default function server(root: string, options?: Options): Middleware;

root

  • Root directory string.
  • Nothing above this root directory can be served.

Options

fs
  • Defaults to node:fs.
  • The file system to used.
headers
  • Defaults to undefined.
  • Set headers to be sent.
  • See docs: Headers in MDN.
acceptRanges
  • Defaults to true.
  • Enable or disable accepting ranged requests.
  • Disabling this will not send Accept-Ranges and ignore the contents of the Range request header.
  • Can be overridden by the headers.
etag
  • Defaults to true.
  • Enable or disable etag generation.
  • Use weak etag internally.
  • Can be overridden by the headers.
lastModified
  • Defaults to true.
  • Enable or disable Last-Modified header.
  • Use the file system's last modified value.
  • Can be overridden by the headers.
ignore
  • Defaults to undefined.
  • Function that determines if a file should be ignored.
defer
  • Defaults to false.
  • If true, serves after await next().
  • Allowing any downstream middleware to respond first.

Example

/**
 * @module server
 * @license MIT
 * @author nuintun
 */

import Koa from 'koa';
import files from 'koa-files';

const app = new Koa();
const port = process.env.PORT || 80;

// Static files server
app.use(
  files('tests', {
    headers: {
      'Cache-Control': 'public, max-age=31557600'
    }
  })
);

/**
 * @function httpError
 * @param {NodeJS.ErrnoException} error
 * @returns {boolean}
 */
function httpError(error) {
  return /^(EOF|EPIPE|ECANCELED|ECONNRESET|ECONNABORTED)$/i.test(error.code);
}

// Listen error event
app.on('error', error => {
  !httpError(error) && console.error(error);
});

// Start server
app.listen(port, () => {
  console.log(`> server running at: 127.0.0.1:${port}`);
});

Features

Support multipart range and download resumption.

License

MIT

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.