diff --git a/doc/api/errors.md b/doc/api/errors.md index 2f7f60983eed7a..1210a721538cb9 100644 --- a/doc/api/errors.md +++ b/doc/api/errors.md @@ -754,6 +754,11 @@ more headers. Used when an invalid character is found in an HTTP response status message (reason phrase). + +### ERR_HTTP_INVALID_HEADER_VALUE + +Used to indicate that an invalid HTTP header value has been specified. + ### ERR_HTTP_INVALID_STATUS_CODE diff --git a/lib/_http_outgoing.js b/lib/_http_outgoing.js index 76d83b19218ceb..b4cfe61d86bf0d 100644 --- a/lib/_http_outgoing.js +++ b/lib/_http_outgoing.js @@ -437,16 +437,7 @@ function _storeHeader(firstLine, headers) { function storeHeader(self, state, key, value, validate) { if (validate) { - if (typeof key !== 'string' || !key || !checkIsHttpToken(key)) { - throw new errors.TypeError( - 'ERR_INVALID_HTTP_TOKEN', 'Header name', key); - } - if (value === undefined) { - throw new errors.TypeError('ERR_MISSING_ARGS', `header "${key}"`); - } else if (checkInvalidHeaderChar(value)) { - debug('Header "%s" contains invalid characters', key); - throw new errors.TypeError('ERR_INVALID_CHAR', 'header content', key); - } + validateHeader(key, value); } state.header += key + ': ' + escapeHeaderValue(value) + CRLF; matchHeader(self, state, key, value); @@ -494,20 +485,27 @@ function matchHeader(self, state, field, value) { } } -function validateHeader(msg, name, value) { - if (typeof name !== 'string' || !name || !checkIsHttpToken(name)) - throw new errors.TypeError('ERR_INVALID_HTTP_TOKEN', 'Header name', name); - if (value === undefined) - throw new errors.TypeError('ERR_MISSING_ARGS', 'value'); - if (msg._header) - throw new errors.Error('ERR_HTTP_HEADERS_SENT', 'set'); - if (checkInvalidHeaderChar(value)) { +function validateHeader(name, value) { + let err; + if (typeof name !== 'string' || !name || !checkIsHttpToken(name)) { + err = new errors.TypeError('ERR_INVALID_HTTP_TOKEN', 'Header name', name); + } else if (value === undefined) { + err = new errors.TypeError('ERR_HTTP_INVALID_HEADER_VALUE', value, name); + } else if (checkInvalidHeaderChar(value)) { debug('Header "%s" contains invalid characters', name); - throw new errors.TypeError('ERR_INVALID_CHAR', 'header content', name); + err = new errors.TypeError('ERR_INVALID_CHAR', 'header content', name); + } + if (err !== undefined) { + Error.captureStackTrace(err, validateHeader); + throw err; } } + OutgoingMessage.prototype.setHeader = function setHeader(name, value) { - validateHeader(this, name, value); + if (this._header) { + throw new errors.Error('ERR_HTTP_HEADERS_SENT', 'set'); + } + validateHeader(name, value); if (!this[outHeadersKey]) this[outHeadersKey] = {}; diff --git a/lib/internal/errors.js b/lib/internal/errors.js index da00ba25915d0e..caa5660022b5ad 100644 --- a/lib/internal/errors.js +++ b/lib/internal/errors.js @@ -317,6 +317,7 @@ E('ERR_HTTP2_UNSUPPORTED_PROTOCOL', E('ERR_HTTP_HEADERS_SENT', 'Cannot %s headers after they are sent to the client'); E('ERR_HTTP_INVALID_CHAR', 'Invalid character in statusMessage.'); +E('ERR_HTTP_INVALID_HEADER_VALUE', 'Invalid value "%s" for header "%s"'); E('ERR_HTTP_INVALID_STATUS_CODE', (originalStatusCode) => `Invalid status code: ${originalStatusCode}`); E('ERR_HTTP_TRAILER_INVALID', diff --git a/test/parallel/test-http-mutable-headers.js b/test/parallel/test-http-mutable-headers.js index 929a566caf5578..2473a08eb1978e 100644 --- a/test/parallel/test-http-mutable-headers.js +++ b/test/parallel/test-http-mutable-headers.js @@ -61,9 +61,9 @@ const s = http.createServer(common.mustCall((req, res) => { common.expectsError( () => res.setHeader('someHeader'), { - code: 'ERR_MISSING_ARGS', + code: 'ERR_HTTP_INVALID_HEADER_VALUE', type: TypeError, - message: 'The "value" argument must be specified' + message: 'Invalid value "undefined" for header "someHeader"' } ); common.expectsError( diff --git a/test/parallel/test-http-outgoing-proto.js b/test/parallel/test-http-outgoing-proto.js index 22eba0981f6fc2..7db252dfbf9855 100644 --- a/test/parallel/test-http-outgoing-proto.js +++ b/test/parallel/test-http-outgoing-proto.js @@ -34,9 +34,9 @@ assert.throws(() => { const outgoingMessage = new OutgoingMessage(); outgoingMessage.setHeader('test'); }, common.expectsError({ - code: 'ERR_MISSING_ARGS', + code: 'ERR_HTTP_INVALID_HEADER_VALUE', type: TypeError, - message: 'The "value" argument must be specified' + message: 'Invalid value "undefined" for header "test"' })); assert.throws(() => { diff --git a/test/parallel/test-http-write-head.js b/test/parallel/test-http-write-head.js index 70ad5935a92690..e254f8d64da349 100644 --- a/test/parallel/test-http-write-head.js +++ b/test/parallel/test-http-write-head.js @@ -44,9 +44,9 @@ const s = http.createServer(common.mustCall((req, res) => { common.expectsError( () => res.setHeader('foo', undefined), { - code: 'ERR_MISSING_ARGS', + code: 'ERR_HTTP_INVALID_HEADER_VALUE', type: TypeError, - message: 'The "value" argument must be specified' + message: 'Invalid value "undefined" for header "foo"' } );