HTTP 模块

Node.js 兼容的 HTTP 服务器模块,提供创建和管理 HTTP 服务器的功能。

功能特性

✅ Node.js 完全兼容 - 实现 Node.js http 模块的核心 API

✅ HTTP 服务器 - 创建和管理 HTTP 服务器

✅ 请求处理 - 完整的请求对象（IncomingMessage）

✅ 响应处理 - 完整的响应对象（ServerResponse）

✅ 事件驱动 - 基于事件的请求处理模型

✅ HTTP 方法 - 支持所有标准 HTTP 方法

✅ 状态码 - 内置 HTTP 状态码常量

基本使用

创建简单的 HTTP 服务器

处理不同的 HTTP 方法

API 参考

http.createServer([requestListener])

创建一个新的 HTTP 服务器。

参数:

requestListener (function, 可选): 请求监听器函数，自动添加到 'request' 事件

返回值: Server - HTTP 服务器实例

示例:

http.Server

HTTP 服务器类,由 createServer() 返回。

事件:

Event: 'request'

req (IncomingMessage): 请求对象

res (ServerResponse): 响应对象

每当有新的请求时触发。

示例:

server.listen(port[, hostname][, callback])

启动 HTTP 服务器,监听指定端口。

参数:

port (number): 要监听的端口号

hostname (string, 可选): 主机名,默认为 '0.0.0.0'

callback (function, 可选): 服务器启动后的回调函数

返回值: Server - 服务器实例(用于链式调用)

示例:

server.close([callback])

停止服务器接受新连接。

参数:

callback (function, 可选): 服务器关闭后的回调函数

返回值: undefined

示例:

server.on(event, listener)

添加事件监听器。

参数:

event (string): 事件名称

listener (function): 监听器函数

返回值: Server - 服务器实例(用于链式调用)

示例:

server.once(event, listener)

添加一次性事件监听器,触发一次后自动移除。

参数:

event (string): 事件名称

listener (function): 监听器函数

返回值: Server - 服务器实例(用于链式调用)

示例:

IncomingMessage (请求对象)

表示传入的 HTTP 请求。

属性

req.method

类型: string

HTTP 请求方法（GET, POST, PUT, DELETE 等）

req.url

类型: string

请求的 URL 字符串

req.path

类型: string

URL 路径部分

req.query

类型: string

URL 查询字符串部分

req.headers

类型: object

请求头对象

req.httpVersion

类型: string

HTTP 版本

req.body

类型: string

请求体内容

方法

req.unpipe()

取消流的管道连接。

返回值: IncomingMessage - 请求对象(用于链式调用)

req.resume()

恢复暂停的流。

返回值: IncomingMessage - 请求对象(用于链式调用)

ServerResponse (响应对象)

表示 HTTP 响应。

属性

res.statusCode

类型: number

HTTP 状态码

res.headersSent

类型: boolean

标头是否已发送

方法

res.writeHead(statusCode[, statusMessage][, headers])

写入响应头。

参数:

statusCode (number): HTTP 状态码

statusMessage (string, 可选): 状态消息

headers (object, 可选): 响应头对象

返回值: ServerResponse - 响应对象(用于链式调用)

示例:

res.setHeader(name, value)

设置单个响应头。

参数:

name (string): 头部名称

value (string): 头部值

返回值: undefined

示例:

res.getHeader(name)

获取已设置的响应头。

参数:

name (string): 头部名称

返回值: string | undefined - 头部值

示例:

res.write(chunk[, encoding][, callback])

写入响应数据。

参数:

chunk (string | Buffer): 要写入的数据

encoding (string, 可选): 编码方式

callback (function, 可选): 数据写入完成后的回调

返回值: boolean - 是否成功写入

示例:

res.end([data][, encoding][, callback])

结束响应。

参数:

data (string | Buffer, 可选): 最后要发送的数据

encoding (string, 可选): 编码方式

callback (function, 可选): 响应完成后的回调

返回值: undefined

示例:

HTTP 常量

http.METHODS

包含所有支持的 HTTP 方法的数组。

示例:

http.STATUS_CODES

HTTP 状态码常量对象。

示例:

http

HTTP 模块#

功能特性#

基本使用#

创建简单的 HTTP 服务器#

处理不同的 HTTP 方法#

API 参考#

http.createServer([requestListener])#

http.Server#

Event: 'request'#

server.listen(port[, hostname][, callback])#

server.close([callback])#

server.on(event, listener)#

server.once(event, listener)#

IncomingMessage (请求对象)#

属性#

req.method#

req.url#

req.path#

req.query#

req.headers#

req.httpVersion#

req.body#

方法#

req.unpipe()#

req.resume()#

ServerResponse (响应对象)#

属性#

res.statusCode#

res.headersSent#

方法#

res.writeHead(statusCode[, statusMessage][, headers])#

res.setHeader(name, value)#

res.getHeader(name)#

res.write(chunk[, encoding][, callback])#

res.end([data][, encoding][, callback])#

HTTP 常量#

http.METHODS#

http.STATUS_CODES#

实际应用场景#

RESTful API 服务器#

静态文件服务器#

路由系统#

中间件模式#

流式响应#

错误处理#

捕获请求错误#

HTTP 模块

功能特性

基本使用

创建简单的 HTTP 服务器

处理不同的 HTTP 方法

API 参考

http.createServer([requestListener])

http.Server

Event: 'request'

server.listen(port[, hostname][, callback])

server.close([callback])

server.on(event, listener)

server.once(event, listener)

IncomingMessage (请求对象)

属性

req.method

req.url

req.path

req.query

req.headers

req.httpVersion

req.body

方法

req.unpipe()

req.resume()

ServerResponse (响应对象)

属性

res.statusCode

res.headersSent

方法

res.writeHead(statusCode[, statusMessage][, headers])

res.setHeader(name, value)

res.getHeader(name)

res.write(chunk[, encoding][, callback])

res.end([data][, encoding][, callback])

HTTP 常量

http.METHODS

http.STATUS_CODES

实际应用场景

RESTful API 服务器

静态文件服务器

路由系统

中间件模式

流式响应

错误处理

捕获请求错误