'use strict'; var debug = require('diagnostics')('setHeader'); /** * This code mimics the internals of the setHeader methods that is found in the * _http_outgoing.js file which node uses as response object. The only big * difference is that we don't throw and crash your application and ensure that * the headers you set using this function CANNOT be removed. * * @param {Response} res The HTTP Outgoing response instance. * @param {String} name The header name. * @param {String} value The value of the header. * @returns {Boolean} The header was set. * @api public */ module.exports = function setHeader(res, name, value) { if (!res || !name || !value || res._header) { return false; } var key = name.toLowerCase(); // // Delegate the header setting magic first to the default setHeader method as // it can also be used to remove automatically injected headers. // res.setHeader(name, value); var symbols = Object.getOwnPropertySymbols ? Object.getOwnPropertySymbols(res) : []; var symbol; if (symbols.length) { for (var i = 0; i < symbols.length; i++) { var str = String(symbols[i]); if (str === 'Symbol(outHeadersKey)' || str === 'Symbol(kOutHeaders)') { symbol = symbols[i]; break; } } } else { symbol = '_headers'; } // // Prevent thrown errors when we want to set the same header again using our // own `setHeader` method. // var described = Object.getOwnPropertyDescriptor(res[symbol], key); if (described && !described.configurable) { return false; } // // Internally, the `res.setHeader` stores the lowercase name and it's value in // a private `_headers` object. We're going to override the value that got set // using the Object.defineProperty so nobody can set the same header again. // Object.defineProperty(res[symbol], key, { configurable: false, enumerable: true, // // Return the value that got set using our `setHeader` method. // get: function get() { return typeof symbol === 'symbol' ? [key, value] : value; }, // // Log an override attempt on our protected header. // set: function set(val) { debug('attempt to override header %s:%s with %s', name, value, val); return value; } }); return true; };