Express.js - How to check if headers have already sent?

Question

Express.js - How to check if headers have already sent?

I am writing a library which may set headers. I want to give a custom error message if headers have already sent, instead of just letting it fail with the "Can't set headers after they are sent" message given by Node.js. So how to check if headers have already sent?

javascript
node.js
express
connect

Answer 1

Simple: Connect's Response class provides a public property "headerSent".

res.headerSent is a boolean value that indicates whether the headers have already been sent to the client.

From the source code:

/**
   * Provide a public "header sent" flag
   * until node does.
   *
   * @return {Boolean}
   * @api public
   */

  res.__defineGetter__('headerSent', function(){
    return this._header;
  });

https://github.com/senchalabs/connect/blob/master/lib/patch.js#L22

Answer 2

Node supports the res.headersSent these days, so you could/should use that. It is a read-only boolean indicating whether the headers have already been sent.

if(res.headersSent) { ... }

See http://nodejs.org/api/http.html#http_response_headerssent

Note: this is the preferred way of doing it, compared to the older Connect 'headerSent' property that Niko mentions.