类:IncomingMessage

优质
小牛编辑
133浏览
2023-12-01

类:IncomingMessage

处理 HTTP/HTTPS 请求的响应。

Process: Main 此类不从 'electron' 模块导出. 它只能作为Electron API中其他方法的返回值。

ClientRequest实现了Readable Stream接口, 因此是一个EventEmitter类型.

实例事件

Event: 'data'

返回:

  • chunk 缓冲区: 响应体数据块。

data事件是将响应数据转换为应用程序代码的常用方法。

Event: 'end'

指示响应正文已结束。 必须在 'data' 事件之前放置。

Event: 'aborted'

正在进行的 HTTP 事务被取消后触发。

Event: 'error'

返回:

error 通常保存一个错误字符串,识别失败的根本原因。

当流响应数据事件遇到错误时发出。 例如, 如果服务器在响应仍在流时关闭基础, 则会在响应对象上发出一个 error 事件, 随后将在请求对象上执行 close 事件。

实例属性

IncomingMessage 实例具有以下可读属性:

response.statusCode

一个指示 HTTP 响应状态代码的 Integer

response.statusMessage

表示HTTP状态消息的string

response.headers

A Record<string, string | string[]> 代表HTTP响应头。 headers对象格式如下:

  • 所有的头文件名是小写的。
  • 以下 header 名均不可重复定义: age, authorization, content-length, content-type, etag, expires, from, host, if-modified-since, if-unmodified-since, last-modified, location, max-forwards, proxy-authorization, referer,retry-after, server, user-agent
  • set-cookie 永远是一个数组。 重复项被添加到数组内。
  • 对于重复的 cookie 头,对应的值会用 '; ' 连接
  • 所有其他 header 的值通过 ',' 连接

response.httpVersion

表示HTTP协议版本号的 String 。 一般是“1”或“1.1”。 此外 httpVersionMajorhttpVersionMinor 两整数值可读属性,分别返回HTTP的主要和次要版本号

response.httpVersionMajor

表示HTTP协议主要版本号的 整数

response.httpVersionMinor

表示http协议次要版本号的整数