Node.js / Express - How do I set response character encoding?

Question

Say I got:

app.get('/json', function(req, res) {     res.set({         'content-type': 'application/json'     }).send('{"status": "0"}'); }); 

I'm trying to send the response as UTF-8 with the following with no success:

app.get('/json', function(req, res) {     // From Node.js Official Doc     // http://nodejs.org/api/http.html#http_http_request_options_callback     res.setEncoding('utf8');      res.set({         'content-type': 'application/json'     }).send('{"status": "0"}'); }); 

What is the correct way to set character encoding in Express?

Answer 1

You will probably want to explicitly add a charset to the end of your content-type string if you find it's not being set already by Express:

 res.set({ 'content-type': 'application/json; charset=utf-8' }); 

The charset is not always set automagically and does need to be set to work correctly everywhere (i.e. with all browsers and all ajax libraries) or you can run into encoding bugs.

In Express 4.x specifically I've found that depending on the object you trying to return, it normally automatically returns with content-type: application/json; charset=utf-8 when you call res.json(someObject), however not always.

When calling res.json() on some objects it can return content-type: application/json (i.e. without the charset encoding!). I'm not actually sure what triggers this, other than it's something about the specific object being returned.

I've only noticed it because of automated tests which explicitly checked the headers and found it was missing the charset declaration on some responses (even though the content-type was still application/json).