Difference between app.all('*') and app.use('/')

Is there a useful difference between app.all('*', ... ) and app.use('/', ...) in Node.JS Express?

In most cases they would work equivalently. The biggest difference is the order in which middleware would be applied:

  • app.all() attaches to the application's router, so it's used whenever the app.router middleware is reached (which handles all the method routes... GET, POST, etc).

  • app.use() attaches to the application's main middleware stack, so it's used in the order specified by middleware. eg, if you put it first, it will be the first thing run. If you put it last, (after the router), it usually won't be run at all.

Usually, if you want to do something globally to all routes, app.use() is the better option. Also, it has less chance of future bugs, since express 0.4 will probably drop the implicit router (meaning, the position of the router in middleware will be more important than it is right now, since you technically don't even have to use it right now).

With app.use(), the "mount" path is stripped and is not visible to the middleware function:

app.use('/static', express.static(__dirname + '/public'));

Mounted middleware functions(express.static) are not invoked unless the req.url contains this prefix (/static), at which point it is stripped when the function is invoked.

With app.all(), there is no that behavior.

  • app.use:

    1. inject middlware to your front controller configuring for instance: header, cookies, sessions, etc.
    2. must be written before app[http_method] otherwise there will be not executed.
    3. several calls are processed in the order of writing
  • app.all:

    1. (like app[http_method]) is used for configuring routes' controllers
    2. "all" means it applies on all http methods.
    3. several calls are processed in the order of writing

Look at this expressJs code sample:

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

app.use(function frontControllerMiddlewareExecuted(req, res, next){
  console.log('(1) this frontControllerMiddlewareExecuted is executed');
  next();
});

app.all('*', function(req, res, next){
  console.log('(2) route middleware for all method and path pattern "*", executed first and can do stuff before going next');
  next();
});

app.all('/hello', function(req, res, next){
  console.log('(3) route middleware for all method and path pattern "/hello", executed second and can do stuff before going next');
  next();
});

app.use(function frontControllerMiddlewareNotExecuted(req, res, next){
  console.log('(4) this frontControllerMiddlewareNotExecuted is not executed');
  next();
});

app.get('/hello', function(req, res){
  console.log('(5) route middleware for method GET and path patter "/hello", executed last and I do my stuff sending response');
  res.send('Hello World');
});

app.listen(80);

Here is the log when accessing route '/hello':

(1) this frontControllerMiddlewareExecuted is executed
(2) route middleware for all method and path pattern "*", executed first and can do stuff before going next
(3) route middleware for all method and path pattern "/hello", executed second and can do stuff before going next
(5) route middleware for method GET and path patter "/hello", executed last and I do my stuff sending response

app.use takes only one callback function and its meant for Middleware. Middleware usually don't handle request and response, (technically they can) they just process input data, and hand over it to next handler in queue.

app.use([path], function)

app.all take multiple callbacks, and meant for routing. with multiple callbacks you can filter requests and send responses. Its explained in Filters on express.js

app.all(path, [callback...], callback)

app.use only see whether url starts with specified path

app.use( "/product" , mymiddleware);
// will match /product
// will match /product/cool
// will match /product/foo

app.all will match complete path

app.all( "/product" , handler);
// will match /product
// won't match /product/cool   <-- important
// won't match /product/foo    <-- important

app.all( "/product/*" , handler);
// won't match /product        <-- Important
// will match /product/cool
// will match /product/foo

Yes, app.all() gets called when a particular URI is requested with any type of request method (POST, GET, PUT, or DELETE)

On other hand app.use() is used for any middleware you might have and it mounts onto a path prefix, and will be called anytime a URI under that route is requested.

Here is the documentation for app.all & app.use.