Handling Express.js Body Parser JSON Exceptions

Express.js, an HTTP server for Node.js, has middleware that you have to install to parse and work with the req body objects on POST routes - the problem is, it doesn't make it particularly easy to handle errors yourself.

One issue that I ran into specifically was the JSON parser being set to strict by default - meaning that only objects and arrays are accepted. This is okay for what I want to do, but if you try to send something like a plain string, an exception is thrown. By default, this will expose a stack trace to the public site, which you probably don't want to do.

Screenshot of a JSON exception being thrown

You can't catch the exception in your handler for the route, or the route definition for that matter. This dashed my hopes of using the middleware route-specifically.

The solution that I thought was best was posted in this github issue for the body-parser repo. It involves adding your own middleware handler after adding body-parser:

const express = require("express");
const app = express();
const port = process.env.PORT || 3000;

app.set("env", "production"); // this is how you prevent public stack traces

app.use(function (err, req, res, next) {
    // ⚙️ our function to catch errors from body-parser
    if (err instanceof SyntaxError && err.status === 400 && "body" in err) {
        // do your own thing here 👍
        res.status(400).send({code: 400, message: "bad request"});
    } else next();

app.post("/", require("./something"));

app.listen(port, () => console.info(`[i] listening on port ${port}`));

You'll only receive email when they publish something new.

More from Matt Crook
All posts