Node.js中如何操作HTTP头？-js教程-PHP中文网

Node.js通过http/https模块操作HTTP头，使用request.headers读取请求头，response.setHeader或res.writeHead设置响应头，注意在发送响应前完成头设置，避免错误；可通过中间件统一处理头信息，如CORS、认证等，结合cookie模块处理Cookie，利用Accept头实现内容协商，确保头字段格式正确、值合法，提升应用安全性与兼容性。

node.js中如何操作http头？

在Node.js中，你可以通过

http

登录后复制

或

https

登录后复制

模块来操作HTTP头，无论是设置请求头还是响应头，都相当直接。核心在于理解

request

登录后复制

和

response

登录后复制

对象，它们分别代表客户端请求和服务器响应。

解决方案

在Node.js中，操作HTTP头主要涉及两个方面：处理客户端请求的头信息以及设置服务器响应的头信息。

处理客户端请求头信息

当Node.js服务器接收到客户端的请求时，请求头信息会包含在

request

登录后复制

对象中。你可以通过

request.headers

登录后复制

属性访问这些头信息，它是一个JavaScript对象，包含了所有请求头字段和对应的值。

const http = require('http');

const server = http.createServer((req, res) => {
  console.log('请求头:', req.headers); // 打印所有请求头

  const userAgent = req.headers['user-agent']; // 获取User-Agent
  console.log('User-Agent:', userAgent);

  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello, World!');
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

这段代码演示了如何访问和打印请求头，以及如何获取特定的请求头字段（例如

User-Agent

登录后复制

）。

设置服务器响应头信息

在服务器端，你需要使用

response

登录后复制

对象来设置响应头。有两种主要的方式：

res.setHeader()

登录后复制

和

res.writeHead()

登录后复制

。

```
res.setHeader(name, value)
```
登录后复制
: 用于设置单个响应头。可以多次调用来设置多个头。
```
res.writeHead(statusCode, [reasonPhrase], [headers])
```
登录后复制
: 用于设置HTTP状态码和响应头。通常在发送响应体之前调用。

const http = require('http');

const server = http.createServer((req, res) => {
  res.setHeader('Content-Type', 'application/json');
  res.setHeader('X-Custom-Header', 'My Custom Value');

  const responseData = { message: 'Hello, World!' };
  res.writeHead(200);
  res.end(JSON.stringify(responseData));
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

在这个例子中，我们使用

res.setHeader()

登录后复制

设置了

Content-Type

登录后复制

和自定义的

X-Custom-Header

登录后复制

。然后，使用

res.writeHead()

登录后复制

设置了状态码200。注意，

res.writeHead()

登录后复制

也可以接受一个包含头信息的对象作为第三个参数，这允许你一次性设置多个头。

一些需要注意的点

大小写不敏感: HTTP头字段名是不区分大小写的，但通常建议使用首字母大写的形式，例如
```
Content-Type
```
登录后复制
。
重复的头: 如果多次设置同一个头，行为取决于具体的头。有些头会覆盖之前的值，有些头会合并多个值。
顺序: 头发送的顺序很重要，特别是对于一些特殊的头，例如
```
Content-Length
```
登录后复制
。
状态码: 确保设置正确的HTTP状态码，这对于客户端正确处理响应至关重要。

如何处理Node.js中常见的HTTP头相关错误？

处理HTTP头时，一些常见的错误包括：尝试在发送响应体后修改头、设置了无效的头值、或者头信息格式不正确。

在发送响应体后修改头: 一旦你调用了

res.end()

登录后复制

或

res.write()

登录后复制

发送了响应体，就不能再修改头了。Node.js会抛出一个错误。

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello, World!');

  // 尝试在res.end()之后设置头，会报错
  // res.setHeader('X-Custom-Header', 'My Custom Value'); // 错误：Cannot set headers after they are sent to the client
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

解决方法是在发送响应体之前设置所有需要的头。

设置无效的头值: 某些头有特定的值格式要求。例如，
```
Content-Length
```
登录后复制
必须是一个整数。如果设置了无效的值，可能会导致客户端无法正确解析响应。
```
res.setHeader('Content-Length', 'abc'); // 错误：Content-Length必须是整数
```
登录后复制
确保按照HTTP规范设置正确的头值。
头信息格式不正确: 头字段名和值之间应该用冒号分隔，并且遵循HTTP协议的格式要求。不正确的格式可能导致客户端无法解析头信息。
```
res.setHeader('Content-Type: text/plain'); // 错误：格式不正确
```
登录后复制
正确的写法是
```
res.setHeader('Content-Type', 'text/plain');
```
登录后复制
CORS错误: 跨域资源共享（CORS）错误是常见的HTTP头相关问题。当客户端从一个域请求另一个域的资源时，浏览器会进行CORS检查。服务器需要设置适当的
```
Access-Control-Allow-Origin
```
登录后复制
头来允许跨域请求。
```
res.setHeader('Access-Control-Allow-Origin', '*'); // 允许所有域
```
登录后复制
更安全的做法是只允许特定的域：
```
res.setHeader('Access-Control-Allow-Origin', 'https://example.com'); // 只允许example.com
```
登录后复制

如何使用Node.js处理Cookie？

Cookie是存储在客户端浏览器中的小型文本文件，用于在客户端和服务器之间传递状态信息。Node.js提供了多种方式来处理Cookie，包括读取请求中的Cookie和设置响应中的Cookie。

读取请求中的Cookie

请求中的Cookie信息包含在

request.headers.cookie

登录后复制

字段中。这个字段是一个字符串，包含了所有Cookie的键值对，用分号和空格分隔。你需要解析这个字符串来获取单个Cookie的值。

const http = require('http');
const cookie = require('cookie');

const server = http.createServer((req, res) => {
  const cookies = cookie.parse(req.headers.cookie || '');

  console.log('Cookies:', cookies);

  const myCookie = cookies.myCookie; // 获取名为myCookie的Cookie
  console.log('myCookie:', myCookie);

  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello, World!');
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

在这个例子中，我们使用了

cookie

登录后复制

模块（需要通过

npm install cookie

登录后复制

安装）来解析

request.headers.cookie

登录后复制

字符串。

cookie.parse()

登录后复制

函数将Cookie字符串转换为一个JavaScript对象，方便我们访问单个Cookie的值。

设置响应中的Cookie

要设置响应中的Cookie，你需要使用

Set-Cookie

登录后复制

头。你可以使用

res.setHeader()

登录后复制

来设置这个头。

PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用

一键操作，智能生成专业级PPT

查看详情

const http = require('http');

const server = http.createServer((req, res) => {
  res.setHeader('Set-Cookie', 'myCookie=myValue; Path=/; HttpOnly'); // 设置Cookie

  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello, World!');
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

在这个例子中，我们设置了一个名为

myCookie

登录后复制

的Cookie，值为

myValue

登录后复制

。

Path=/

登录后复制

表示这个Cookie对整个域名有效。

HttpOnly

登录后复制

表示这个Cookie只能通过HTTP访问，不能通过JavaScript访问，这有助于防止XSS攻击。

Cookie选项

Set-Cookie

登录后复制

头支持多个选项，用于控制Cookie的行为：

```
Path
```
登录后复制
: 指定Cookie的有效路径。
```
Domain
```
登录后复制
: 指定Cookie的有效域名。
```
Expires
```
登录后复制
: 指定Cookie的过期时间。
```
Max-Age
```
登录后复制
: 指定Cookie的有效期（秒）。
```
Secure
```
登录后复制
: 指定Cookie只能通过HTTPS连接发送。
```
HttpOnly
```
登录后复制
: 指定Cookie只能通过HTTP访问。
```
SameSite
```
登录后复制
: 指定Cookie的跨站行为（
```
Strict
```
登录后复制
,
```
Lax
```
登录后复制
,
```
None
```
登录后复制
）。

你可以通过在

Set-Cookie

登录后复制

头中添加这些选项来更精细地控制Cookie的行为。例如：

res.setHeader('Set-Cookie', [
  'myCookie=myValue; Path=/; HttpOnly',
  'anotherCookie=anotherValue; Domain=example.com; Max-Age=3600'
]);

登录后复制

这段代码设置了两个Cookie，一个设置了

HttpOnly

登录后复制

选项，另一个设置了

Domain

登录后复制

和

Max-Age

登录后复制

选项。

如何在Node.js中使用HTTP头进行内容协商？

内容协商是一种机制，允许客户端和服务器就响应的最佳表示形式达成一致。客户端通过

Accept

登录后复制

、

Accept-Language

登录后复制

、

Accept-Encoding

登录后复制

等请求头来表达其偏好，服务器根据这些偏好选择最合适的响应内容。

处理

Accept

登录后复制

头

Accept

登录后复制

头指定客户端可以接受的内容类型。服务器可以解析这个头，并根据客户端的偏好返回不同类型的响应。

const http = require('http');

const server = http.createServer((req, res) => {
  const accept = req.headers['accept'];

  if (accept.includes('application/json')) {
    res.setHeader('Content-Type', 'application/json');
    const responseData = { message: 'Hello, World!' };
    res.end(JSON.stringify(responseData));
  } else if (accept.includes('text/html')) {
    res.setHeader('Content-Type', 'text/html');
    res.end('<h1>Hello, World!</h1>');
  } else {
    res.setHeader('Content-Type', 'text/plain');
    res.end('Hello, World!');
  }
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

在这个例子中，服务器根据

Accept

登录后复制

头的值返回不同类型的响应。如果客户端接受

application/json

登录后复制

，则返回JSON格式的响应；如果客户端接受

text/html

登录后复制

，则返回HTML格式的响应；否则，返回纯文本格式的响应。

处理

Accept-Language

登录后复制

头

Accept-Language

登录后复制

头指定客户端可以接受的语言。服务器可以解析这个头，并根据客户端的偏好返回不同语言的响应。

const http = require('http');

const server = http.createServer((req, res) => {
  const acceptLanguage = req.headers['accept-language'];

  let message = 'Hello, World!';

  if (acceptLanguage.includes('zh')) {
    message = '你好，世界！';
  } else if (acceptLanguage.includes('fr')) {
    message = 'Bonjour, le monde!';
  }

  res.setHeader('Content-Type', 'text/plain; charset=utf-8');
  res.end(message);
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

在这个例子中，服务器根据

Accept-Language

登录后复制

头的值返回不同语言的问候语。

处理

Accept-Encoding

登录后复制

头

Accept-Encoding

登录后复制

头指定客户端可以接受的编码方式（例如gzip、deflate）。服务器可以根据这个头选择合适的编码方式来压缩响应，从而减少传输大小。

const http = require('http');
const zlib = require('zlib');

const server = http.createServer((req, res) => {
  const acceptEncoding = req.headers['accept-encoding'];

  let raw = 'Hello, World!'.repeat(1000); // 创建一个较大的字符串

  if (acceptEncoding && acceptEncoding.includes('gzip')) {
    zlib.gzip(raw, (err, compressed) => {
      if (err) {
        console.error(err);
        res.writeHead(500);
        res.end('Error compressing response');
        return;
      }
      res.setHeader('Content-Encoding', 'gzip');
      res.writeHead(200, {'Content-Type': 'text/plain'});
      res.end(compressed);
    });
  } else {
    res.writeHead(200, {'Content-Type': 'text/plain'});
    res.end(raw);
  }
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

在这个例子中，服务器首先检查

Accept-Encoding

登录后复制

头是否包含

gzip

登录后复制

。如果包含，则使用

zlib.gzip()

登录后复制

函数压缩响应，并设置

Content-Encoding

登录后复制

头为

gzip

登录后复制

。否则，直接返回未压缩的响应。

使用第三方库

一些第三方库可以简化内容协商的处理，例如

negotiator

登录后复制

。这些库可以解析

Accept

登录后复制

、

Accept-Language

登录后复制

、

Accept-Encoding

登录后复制

等头，并根据客户端的偏好选择最佳的响应。

如何使用中间件来处理HTTP头？

中间件是在请求到达最终路由处理程序之前执行的函数。它们可以用于处理各种任务，包括修改请求或响应头。在Express.js等框架中，中间件是处理HTTP头的常用方法。

const express = require('express');
const app = express();

// 中间件示例：设置全局的X-Powered-By头
app.use((req, res, next) => {
  res.setHeader('X-Powered-By', 'Node.js');
  next(); // 调用next()传递控制权给下一个中间件或路由处理程序
});

// 中间件示例：处理CORS
app.use((req, res, next) => {
  res.setHeader('Access-Control-Allow-Origin', '*');
  res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE');
  res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
  next();
});

// 路由处理程序
app.get('/', (req, res) => {
  res.send('Hello, World!');
});

app.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

在这个例子中，我们定义了两个中间件。第一个中间件设置了全局的

X-Powered-By

登录后复制

头，用于标识服务器使用的技术。第二个中间件处理了CORS，允许来自任何域的跨域请求。

使用中间件处理请求头

中间件也可以用于处理请求头。例如，你可以创建一个中间件来检查请求头中是否包含特定的认证信息。

const express = require('express');
const app = express();

// 中间件示例：检查认证信息
app.use((req, res, next) => {
  const authHeader = req.headers['authorization'];

  if (!authHeader) {
    return res.status(401).send('Unauthorized');
  }

  // 在这里验证authHeader的值
  // 例如，检查是否与预期的令牌匹配

  next();
});

// 路由处理程序
app.get('/protected', (req, res) => {
  res.send('Protected Resource');
});

app.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

在这个例子中，中间件检查请求头中是否包含

Authorization

登录后复制

头。如果不包含，则返回401 Unauthorized错误。如果包含，则可以进一步验证

Authorization

登录后复制

头的值，例如检查是否与预期的令牌匹配。

使用

express.json()

登录后复制

和
express.urlencoded()
登录后复制
中间件

express.json()

登录后复制

和

express.urlencoded()

登录后复制

是Express.js内置的中间件，用于解析请求体中的JSON和URL编码的数据。它们会自动设置

Content-Type

登录后复制

头为

application/json

登录后复制

或

application/x-www-form-urlencoded

登录后复制

。

const express = require('express');
const app = express();

app.use(express.json()); // 解析JSON请求体
app.use(express.urlencoded({ extended: true })); // 解析URL编码的请求体

app.post('/data', (req, res) => {
  console.log('请求体:', req.body);
  res.send('Data received');
});

app.listen(3000, () => {
  console.log('Server running on port 3000');
});

登录后复制

在这个例子中，