ExpressJS middleware for SPDY server push based on referrer headers.
Install the module:
$ npm install spdy-referrer-push
Import the module:
var spdyPush = require('spdy-referrer-push');
Add as middleware to your already SPDY-enabled Express server:
If using the
express.static or other resource serving middleware, the
spdy-referrer-push middleware must appear
before those other middleware in the stack.
Minimal server with SSL/TLS support:
$ npm install spdy-referrer-push spdy express
var spdyPush =spdy =express =path =fs = ;var app = ;app;var options =key: fscert: fs;var port = 8443;spdy;
Minimal SPDY server without SSL/TLS support (keep in mind that most browsers don't support SPDY without SSL/TLS by default):
var spdyPush =spdy =express =fs = ;var app = ;app;var options =plain: truessl: false;var port = 8080;spdy;
The excellent node-spdy module provides the plumbing necessary for SPDY support in NodeJS (and Connect/Express, including server push. However, hardcoding which resources to push in the server implementation isn't ideal as this must be kept in sync with references in HTML and CSS files.
The Jetty servlet container for Java has a good solution for this problem, called the
ReferrerPushStrategy, where the
HTTP Referer request header is used to track what
resource requests (say
/index.html) trigger subsequent requests for additional resources. This is recorded and used
to determine what additional resources to push the next time someone requests the same main resource (say
The middleware retrieves resources to be pushed by creating an "internal" request/response pair and calling Connect's
app.handle function. This function kicks off
request handling using the server's middleware stack.
This approach avoids the overhead of a new socket connection and a TLS handshake (for resources served via https) while still supporting dynamic behaviour in the handling of resource requests. For instance, if your CSS resources are transpiled from LESS files on the fly, these CSS resources can still be pushed correctly to the client.
The "internal" request and response objects support the full Express request and response APIs but don't yet support all the optional arguments of the NodeJS Stream API. This is work in progress (see the To Do section).
When To Use
This module provides a simple way to test the impact that SPDY with server push can have on improving latency on your
site. Combine it with
tc (on Unix systems) or Apple's Network Link Conditioner,
to test your site under various latency and bandwidth constraints. You will see the biggest benefit in high latency
For serious large scale use I would recommend serving static resources from a web server like
Apache httpd or nginx instead of serving them from your NodeJS
server. mod_spdy is available for Apache httpd 2.2 or later and
supports server push when running
as a reverse proxy in front of the NodeJS application via the
X-Associated-Content response header. That will take
you back to the problem of keeping the list of resources in sync between the NodeJS server and your HTML/CSS though.
Setup Travis CI build.
- The "internal" request and response objects should support the full Stream API, including all optional arguments.
- Compare referrer header based on scheme + hostname + port rather than just hostname + port.
- Support for the
trust proxyExpress application setting.
- Improved configurability to match the Jetty API.
- General code cleanup
- Allow for use with plain Connect (without Express).