Skip to content
This repository has been archived by the owner on Aug 17, 2023. It is now read-only.

toajs/toa-static

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

toa-static

A static server module for toa.

NPM version Build Status Downloads

Demo

'use strict';

var Toa = require('toa')
var toaStatic = require('toa-static')('examples/static')

use as middleware:

var app = Toa()
app.use(toaStatic)
app.listen(3000)

Installation

npm install toa-static

API

var ToaStatic = require('toa-static')

ToaStatic(options)

Return a thunk function.

  • options.root (String) - The directory you wish to serve, default to process.cwd.
  • options.index (String) - By default this module will send "index.html" files in response to a request on a directory. To disable this set false or to supply a new index pass a string.
  • options.etag (Boolean) - Enable or disable etag generation, defaults to true.
  • options.maxAge (Number) - Cache control max age (ms) for the files, default to 24 * 60 * 60 * 30 * 1000.
  • options.cacheControl (String) - Optional cache control header. Overrides options.maxAge.
  • options.compress (Boolean) - When request's accept-encoding include gzip or deflate, files will compressed.
  • options.fileMap (Object) - Object map of aliases.
  • options.prefix (String) - The url prefix you wish to serve as static request, default to '/'.
  • options.prunePrefix (Boolean) - Prune the prefix from URL path, default to false.
  • options.files (Array) - files path you wish to serve.
  • options.staticPath (Function) - Function to return a custom static file path. the context of this function is toa's context.
  • options.maxCacheLength (Number) - The maximum length of the files cache in bytes. if cache's size > maxCacheLength, then the least recently used (LRU) file will be removed. if maxCacheLength === -1, cache will not be used. if maxCacheLength === 0, there is no limit. , default to 0.

License

The MIT License (MIT)