http.validateHeaderName(name[, label])


  • name <string>
  • label <string> 错误信息的标签。默认值: 'Header name'

对提供的 name 执行低级验证,这些验证在调用 res.setHeader(name, value) 时进行。

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

将非法值作为 name 传递会导致抛出 TypeError,错误代码为 code: 'ERR_INVALID_HTTP_TOKEN'

【Passing illegal value as name will result in a TypeError being thrown, identified by code: 'ERR_INVALID_HTTP_TOKEN'.】

在向 HTTP 请求或响应传递头信息之前,不必使用此方法。HTTP 模块会自动验证这些头信息。

【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.】

示例:

【Example:】

import { validateHeaderName } from 'node:http';

try {
  validateHeaderName('');
} catch (err) {
  console.error(err instanceof TypeError); // --> true
  console.error(err.code); // --> 'ERR_INVALID_HTTP_TOKEN'
  console.error(err.message); // --> 'Header name must be a valid HTTP token [""]'
}const { validateHeaderName } = require('node:http');

try {
  validateHeaderName('');
} catch (err) {
  console.error(err instanceof TypeError); // --> true
  console.error(err.code); // --> 'ERR_INVALID_HTTP_TOKEN'
  console.error(err.message); // --> 'Header name must be a valid HTTP token [""]'
}