static 0.4.0
Install from the command line:
Learn more about npm packages
$ npm install @curveball/static@0.4.0
Install via package.json:
"@curveball/static": "0.4.0"
About this version
This package is a middleware for Curveball. It serves static files from a directory.
npm install @curveball/static
import { Application } from '@curveball/kernel';
import serveFiles from '@curveball/static';
import { join } from 'path';
const app = new Application();
app.use(
serveFiles({
// Absolute path to assets directory
staticDir: join(__dirname, 'assets'),
})
);
It is possible to serve files from a directory that doesn't math your request path.
For example:
Static Dir | Request URI |
---|---|
/home/app/static |
/assets/app.css |
You would configure it like this:
import { Application } from '@curveball/kernel';
import serveFiles from '@curveball/static';
import { join } from 'path';
const app = new Application();
app.use(
serveFiles({
// Absolute path to assets directory
staticDir: join(__dirname, 'static'),
pathPrefix: '/assets',
})
);
The default export for this package is the serveFiles
function. When called, this
function returns a middleware. It accepts a dictionary of configuration options.
-
staticDir
: Absolute path to assets directory. Assets cannot be served above this directory. -
pathPrefix
: Request path to match if it differs from the static directory. -
maxAge
: If specified, this will cause aCache-Control: max-age=n
header to be added, wheren
is the value ofmaxAge
.