ClientRequest

ClientRequest类

发出HTTP / HTTPS请求。

Process: Main

ClientRequest实现可写入流接口，因此是EventEmitter。

new ClientRequest(options)

options（Object | String） - 如果options是字符串，则将其解释为请求URL。如果它是一个对象，则需要通过以下属性完全指定一个HTTP请求：

options如属性protocol，host，hostname，port和path作为在所述的严格遵循Node.js的模型URL模块。

例如，我们可能已经创建了与'github.com'相同的请求，如下所示：

const request = net.request{
  method: 'GET',
  protocol: 'https:',
  hostname: 'github.com',
  port: 443,
  path: '/'
})

实例事件

Event: ‘response’

response IncomingMessage - 表示HTTP响应消息的对象。

Event: ‘login’

authInfo Object

当身份验证代理要求用户凭证时发出。

callback预计该功能将用用户凭证回叫：

username String

request.on('login', (authInfo, callback) => {
  callback('username', 'password')
})

提供空凭证将取消该请求并在响应对象上报告身份验证错误：

request.on('response', (response) => {
  console.log(`STATUS: ${response.statusCode}`
  response.on('error', (error) => {
    console.log(`ERROR: ${JSON.stringify(error)}`)
  })
})
request.on('login', (authInfo, callback) => {
  callback()
})

Event: ‘finish’

在最后一块request数据被写入request对象之后发射。

Event: ‘abort’

request中止时发射。如果该abort事件request已经关闭，该事件不会被解雇。

Event: ‘error’

error 错误 - 提供有关失败的一些信息的错误对象。

当net模块发出网络请求失败时发出。通常，当request对象发出一个error事件时，close事件将随后跟随，并且不会提供响应对象。

Event: ‘close’

作为HTTP请求 - 响应事务中的最后一个事件发出。该close事件表示不会再有事件发生在这些request或response对象上。

Event: ‘redirect’

statusCode Integer

重定向时发射，模式为manual。调用request.followRedirect将继续进行重定向。

Instance Properties

request.chunkedEncoding

Boolean指定将使用HTTP请求是否块传输编码或没有。默认为false。该属性是可读写的，但只能在第一次写入操作之前设置，因为HTTP头尚未放置在线上。chunkedEncoding在第一次写入之后试图设置属性会引发错误。

Using chunked encoding is strongly recommended if you need to send a large request body as data will be streamed in small chunks instead of being internally buffered inside Electron process memory.

Instance Methods

request.setHeader(name, value)

name String - An extra HTTP header name.

添加一个额外的HTTP标头。标题名称将按照原样发布，而不是压缩。它只能在第一次写入之前调用。在第一次写入之后调用此方法将引发错误。如果传递的值不是a String，toString()则会调用其方法来获取最终值。

request.getHeader(name)

name String - Specify an extra header name.

Returns Object - The value of a previously set extra header name.

request.removeHeader(name)

name 字符串 - 指定一个额外的标题名称。

删除以前设置的额外标题名称。此方法只能在第一次写入之前调用。在第一次写入之后尝试调用它会引发错误。

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

chunk（String | Buffer） - 请求主体数据的块。如果它是一个字符串，它将使用指定的编码转换为一个Buffer。

callback实质上是一个为了保持与Node.js API相似性而引入的虚拟函数。在chunk内容传送到Chromium网络层后，它在下一个滴答声中被异步调用。与Node.js实现相反，不保证chunk内容在callback被调用之前已经在线上刷新。

向请求主体添加一大块数据。第一次写入操作可能会导致请求标头在线上发出。第一次写入操作后，不允许添加或删除自定义标题。

request.end([chunk][, encoding][, callback])

chunk （字符串|缓冲区）（可选）

发送请求数据的最后一个块。后续的写入或结束操作将不被允许。该finish事件在结束操作后立即发出。

request.abort()

取消正在进行的HTTP事务。如果请求已经发出close事件，则中止操作将不起作用。否则，正在进行的事件将发射abort和close事件。另外，如果有一个正在进行的响应对象，它将发出aborted事件。

request.followRedirect()

重定向模式为时，继续执行任何延迟重定向请求manual。