This package provides an Express compatible middleware which integrates the asset loader package into your application and adds it to each response making it available to your application's route handlers. The asset loader helps applications to locate their static assets from wherever they are stored on the file system or web.
In addition this package can also be used to serve static files.
This package is compatible with Node 12+ and is distributed on npm.
npm install --save @financial-times/dotcom-middleware-asset-loaderAfter installing the package create a new instance of the middleware and register it with your application. The middleware can be configured with several options:
const express = require('express')
const app = express()
+ const assetLoader = require('@financial-times/dotcom-middleware-asset-loader')
+ app.use(assetLoader.init())Once registered an assetLoader property will be added to the response locals object which provides an instance of the asset loader (used to locate your static assets.)
app.get('/', (request, response) => {
const { assetLoader } = response.locals
// Get the absolute file system path to an asset
const filePath = assetLoader.getFileSystemPath('main.css')
// Get the public URL to an asset
const publicURL = assetLoader.getPublicURL('main.css')
response.send('<p>My awesome page</p>')
})See the asset loader package documentation for a complete list of available methods.
The middleware accepts the following parameters. All options will be passed along to the asset loader:
Enable static static assets to be served from a local directory. Uses the Express static middleware to load assets from the configured fileSystemPath and serve them from the configured publicPath. Defaults to false.
See the asset loader documentation for more details.
See the asset loader documentation for more details.
See the asset loader documentation for more details.
See the asset loader documentation for more details.