connect-flash-light

This is a dead simple approach to flashing data, connect-middleware style. It is completely unopinionated and highly-versatile. If you've got something you would like to live until the next request, this should do the trick.

Install

$ npm install connect-flash-light

Usage

Express 4.x

connect-flash-light uses the session to store flash messages. So first, you will need to include the session middleware, which in turn requires the cookieParser middleware.

1var express      = require('express');
2var cookieParser = require('cookie-parser');
3var session      = require('express-session');
4var flash        = require('connect-flash-light');
5
6var app = express();
7
8app.use(express.cookieParser());
9app.use(express.session());
10app.use(flash());

You can now use the req.flash() function to flash whatever you would like. To set messages, use the format req.flash(key, value). The value can be an valid JavaScript value. To retrieve a message, use the format req.flash(key).

A simple string value

1app.get('/flash', function(req, res) {
2  req.flash('msg', 'Your message was flashed!');
3  res.redirect('/');
4});
5
6app.get('/', function(req, res) {
7  res.render('index', { messages: req.flash('msg') });
8});

Form Handling

1app.post('/form', function(req, res) {
2  // Pass the user input back
3  req.flash('input', req.body);
4  // Namespace messages, instead of just a simple string
5  req.flash('msgs', {
6    forms: {
7      errors: {
8        'There was a form error!'
9      }
10    }
11  });
12  res.redirect('/form');
13});
14
15app.get('/form', function(req, res) {
16  var input = req.flash('input');
17  var msgs = req.flash('msgs');
18  res.render('form', {
19    input: input,
20    messages: msgs
21  });
22});

License

The MIT License

Copyright 2014 Elliot Fleming <http://elliotfleming.com>