http.validateHeaderName(name[, label])
-
name
<string> -
label
<string> 错误消息的标签。默认值:'Header name'
。¥
label
<string> Label for error message. Default:'Header name'
.
在调用 res.setHeader(name, value)
时对提供的 name
执行低层验证。
¥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 [""]'
}