super hash powers for express view rendering
Last updated 4 years ago by defunctzombie .
MIT · Original npm · Tarball · package.json
$ cnpm install taters 
SYNC missed versions from official npm registry.


Build Status

taters is an automatic resource hashing middleware for express. Injects resource fingerprints into static resource urls. Optionally inject a prefix for CDN deployments.


    <link href="/css/style.css">
    <script src="/js/index.js"></script>


    <link href="/static/1db360/css/style.css">
    <script src="/static/e9038a/js/index.js"></script>

And taters will add the appropriate cache expiry headers.


var express = require('express');
var taters = require('taters');

var app = express();

app.set('view engine', 'hbs'); // or jade or whatevs
app.set('views', __dirname + '/views');

// taters will setup itself on the app

// you can now serve static content with the regular static middleware
// no need to set a longer cachetime or anything since taters does that for us
app.use(express.static(__dirname + '/public'));

// render your views as before
// tater will replace script, link, img urls with fingerprinted ones
app.get('/', function(req, res, next) {


taters(app, opt)

Taters accepts some options to configure behavior

option type default description
cache Boolean false true will cache url hashes to be cached
prefix String prefix all changed url with this path
middleware Function optional function called wieh /static/ middleware is encountered
exclude Array [] Do not hash a url that contains string or if regex returns true


middleware is an optional function which will be called when /static/ middleware is encountered. You can do things like set longer expiries, better cache headers, etc...

By default, taters middleware sets an expiry of 1 year. This lets browsers, proxies, and CDNs cache the resource for a long time since the hash changes when the resource changes.

Detecting Taters Requests

You can detect incoming taters requests by checking if req.internalTatersRequest is true. This is helpful to bypass authentication and tweak logging.


Taters makes it very easy to use a CDN in production. Simply set the prefix option to the domain of your CDN and your resources will be served via CDN.

Current Tags

  • 1.2.0                                ...           latest (4 years ago)

11 Versions

  • 1.2.0                                ...           4 years ago
  • 1.1.0                                ...           6 years ago
  • 1.0.0                                ...           6 years ago
  • 0.2.0                                ...           6 years ago
  • 0.1.0                                ...           7 years ago
  • 0.0.5                                ...           8 years ago
  • 0.0.4                                ...           8 years ago
  • 0.0.3                                ...           8 years ago
  • 0.0.2                                ...           8 years ago
  • 0.0.1                                ...           8 years ago
  • 0.0.0                                ...           8 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (3)
Dev Dependencies (5)
Dependents (1)

Copyright 2014 - 2017 © taobao.org |