http.isValidHeaderName(name)


如果 name 是一个有效的 HTTP 头名称(一个非空字符串,且是 HTTP 令牌),则返回 true,否则返回 false。这和 http.validateHeaderName() 做的检查是一样的,但结果会被返回而不是抛出错误,因此适合在预期会出现无效输入的高频路径中使用。

🌐 Returns true if name is a valid HTTP header name (a non-empty string that is an HTTP token), and false otherwise. This is the same check that http.validateHeaderName() performs, but the result is returned instead of an error being thrown, so it is suitable for use in hot paths where invalid input is expected.

HTTP 方法也是令牌,所以这个函数也可以验证它们。

🌐 HTTP methods are also tokens, so this function can validate them as well.

import { isValidHeaderName } from 'node:http';

console.log(isValidHeaderName('content-type')); // true
console.log(isValidHeaderName('X-Request-Id')); // true
console.log(isValidHeaderName('')); // false
console.log(isValidHeaderName('bad header')); // false
console.log(isValidHeaderName(42)); // falseconst { isValidHeaderName } = require('node:http');

console.log(isValidHeaderName('content-type')); // true
console.log(isValidHeaderName('X-Request-Id')); // true
console.log(isValidHeaderName('')); // false
console.log(isValidHeaderName('bad header')); // false
console.log(isValidHeaderName(42)); // false