81 lines
3.5 KiB
TypeScript
81 lines
3.5 KiB
TypeScript
// Generated by typings
|
|
// Source: https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/26a1f8c44f5fe76168df717020bfb93839b63db3/serve-static/serve-static.d.ts
|
|
declare module "serve-static" {
|
|
import * as express from "express-serve-static-core";
|
|
|
|
/**
|
|
* Create a new middleware function to serve files from within a given root directory.
|
|
* The file to serve will be determined by combining req.url with the provided root directory.
|
|
* When a file is not found, instead of sending a 404 response, this module will instead call next() to move on to the next middleware, allowing for stacking and fall-backs.
|
|
*/
|
|
function serveStatic(root: string, options?: serveStatic.ServeStaticOptions): express.Handler;
|
|
|
|
import * as m from "mime";
|
|
|
|
namespace serveStatic {
|
|
var mime: typeof m;
|
|
interface ServeStaticOptions {
|
|
/**
|
|
* Set how "dotfiles" are treated when encountered. A dotfile is a file or directory that begins with a dot (".").
|
|
* Note this check is done on the path itself without checking if the path actually exists on the disk.
|
|
* If root is specified, only the dotfiles above the root are checked (i.e. the root itself can be within a dotfile when when set to "deny").
|
|
* The default value is 'ignore'.
|
|
* 'allow' No special treatment for dotfiles
|
|
* 'deny' Send a 403 for any request for a dotfile
|
|
* 'ignore' Pretend like the dotfile does not exist and call next()
|
|
*/
|
|
dotfiles?: string;
|
|
|
|
/**
|
|
* Enable or disable etag generation, defaults to true.
|
|
*/
|
|
etag?: boolean;
|
|
|
|
/**
|
|
* Set file extension fallbacks. When set, if a file is not found, the given extensions will be added to the file name and search for.
|
|
* The first that exists will be served. Example: ['html', 'htm'].
|
|
* The default value is false.
|
|
*/
|
|
extensions?: string[];
|
|
|
|
/**
|
|
* Let client errors fall-through as unhandled requests, otherwise forward a client error.
|
|
* The default value is false.
|
|
*/
|
|
fallthrough?: boolean;
|
|
|
|
/**
|
|
* 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 or an array in preferred order.
|
|
*/
|
|
index?: boolean|string|string[];
|
|
|
|
/**
|
|
* Enable or disable Last-Modified header, defaults to true. Uses the file system's last modified value.
|
|
*/
|
|
lastModified?: boolean;
|
|
|
|
/**
|
|
* Provide a max-age in milliseconds for http caching, defaults to 0. This can also be a string accepted by the ms module.
|
|
*/
|
|
maxAge?: number|string;
|
|
|
|
/**
|
|
* Redirect to trailing "/" when the pathname is a dir. Defaults to true.
|
|
*/
|
|
redirect?: boolean;
|
|
|
|
/**
|
|
* Function to set custom headers on response. Alterations to the headers need to occur synchronously.
|
|
* The function is called as fn(res, path, stat), where the arguments are:
|
|
* res the response object
|
|
* path the file path that is being sent
|
|
* stat the stat object of the file that is being sent
|
|
*/
|
|
setHeaders?: (res: express.Response, path: string, stat: any) => any;
|
|
}
|
|
}
|
|
|
|
export = serveStatic;
|
|
}
|