• name {string}
    • value {any}

    Performs the low-level validations on the provided value that are done when res.setHeader(name, value) is called.

    Passing illegal value as value will result in a [TypeError][] being thrown.

    • Undefined value error is identified by code: 'ERR_HTTP_INVALID_HEADER_VALUE'.
    • Invalid value character error is identified by code: 'ERR_INVALID_CHAR'.

    It is not necessary to use this method before passing headers to an HTTP request or response. The HTTP module will automatically validate such headers.

    Examples:

    1. const { validateHeaderValue } = require('http');
    3. try {
    4.   validateHeaderValue('x-my-header', undefined);
    5. } catch (err) {
    6.   err instanceof TypeError; // --> true
    7.   err.code === 'ERR_HTTP_INVALID_HEADER_VALUE'; // --> true
    8.   err.message; // --> 'Invalid value "undefined" for header "x-my-header"'
    9. }
    11. try {
    12.   validateHeaderValue('x-my-header', 'oʊmɪɡə');
    13. } catch (err) {
    14.   err instanceof TypeError; // --> true
    15.   err.code === 'ERR_INVALID_CHAR'; // --> true
    16.   err.message; // --> 'Invalid character in header content ["x-my-header"]'
    17. }