跳转到主要内容

net

使用 Chromium 的原生网络库发出 HTTP/HTTPS 请求

进程： 主进程, 实用进程

net 模块是一个用于发出 HTTP(S) 请求的客户端 API。它与 Node.js 的 HTTP 和 HTTPS 模块类似，但使用 Chromium 的原生网络库而不是 Node.js 的实现，从而为 Web 代理提供更好的支持。它还支持检查网络状态。

以下是你可能考虑使用 net 模块而不是原生 Node.js 模块的理由（非详尽列表）：

  • 自动管理系统代理配置，支持 wpad 协议和代理 pac 配置文件。
  • HTTPS 请求的自动隧道。
  • 支持使用基本、摘要、NTLM、Kerberos 或 negotiate 身份验证方案进行代理身份验证。
  • 支持流量监控代理：类似 Fiddler 的代理，用于访问控制和监控。

API 组件（包括类、方法、属性和事件名称）与 Node.js 中使用的类似。

示例用法

const { app } = require('electron')
app.whenReady().then(() => {
  const { net } = require('electron')
  const request = net.request('https://github.com')
  request.on('response', (response) => {
    console.log(`STATUS: ${response.statusCode}`)
    console.log(`HEADERS: ${JSON.stringify(response.headers)}`)
    response.on('data', (chunk) => {
      console.log(`BODY: ${chunk}`)
    })
    response.on('end', () => {
      console.log('No more data in response.')
    })
  })
  request.end()
})

net API 只能在应用程序发出 ready 事件后使用。在 ready 事件之前尝试使用该模块将抛出错误。

方法​

net 模块具有以下方法：

net.request(options)​

返回 ClientRequest

使用提供的 options 创建一个 ClientRequest 实例，这些选项将直接传递给 ClientRequest 构造函数。net.request 方法将用于根据 options 对象中指定的协议方案发出安全和不安全 HTTP 请求。

net.fetch(input[, init])​

返回 Promise<GlobalResponse> - 请参阅 Response。

发送请求，类似于渲染器中 fetch() 的工作方式，使用 Chrome 的网络堆栈。这与 Node.js 的 fetch() 不同，后者使用 Node.js 的 HTTP 堆栈。

示例

async function example () {
  const response = await net.fetch('https://my.app')
  if (response.ok) {
    const body = await response.json()
    // ... use the result.
  }
}

此方法将从 默认会话发出请求。要从其他会话发送 fetch 请求，请使用 ses.fetch()。

有关更多详细信息，请参阅 MDN 文档中的 fetch()。

限制

  • net.fetch() 不支持 data: 或 blob: 方案。
  • integrity 选项的值将被忽略。
  • 返回的 Response 对象的 .type 和 .url 值不正确。

默认情况下，使用 net.fetch 发出的请求可以发送到 自定义协议以及 file:，并且会触发 webRequest 处理程序（如果存在）。当在 RequestInit 中设置了非标准的 bypassCustomProtocolHandlers 选项时，自定义协议处理程序将不会为此请求调用。这允许将拦截的请求转发到内置处理程序。即使绕过自定义协议，webRequest 处理程序仍将被触发。

protocol.handle('https', (req) => {
  if (req.url === 'https://my-app.com') {
    return new Response('<body>my app</body>')
  } else {
    return net.fetch(req, { bypassCustomProtocolHandlers: true })
  }
})
注意

在 实用进程中，不支持自定义协议。

net.isOnline()​

返回 boolean - 当前是否有互联网连接。

返回 false 是用户无法连接到远程站点的强烈指标。然而，返回 true 并不确定；即使某个连接已建立，也不能确定连接到某个特定远程站点的尝试是否会成功。

net.resolveHost(host, [options])​

  • host string - 要解析的主机名。
  • options Object (可选)
    • queryType string (可选) - 请求的 DNS 查询类型。如果未指定，解析器将根据 IPv4/IPv6 设置选择 A 或 AAAA（或两者）。
      • A - 仅获取 A 记录
      • AAAA - 仅获取 AAAA 记录。
    • source string (可选) - 用于解析地址的源。默认情况下，解析器会选择合适的源。仅影响大型外部源的使用（例如，调用系统进行解析或使用 DNS）。即使指定了源，结果仍可能来自缓存、解析 "localhost" 或 IP 地址字面量等。以下值之一：
      • any (默认) - 解析器将选择合适的源。结果可能来自 DNS、MulticastDNS、HOSTS 文件等。
      • system - 结果仅从系统或操作系统检索，例如通过 getaddrinfo() 系统调用。
      • dns - 结果仅来自 DNS 查询。
      • mdns - 结果仅来自组播 DNS 查询。
      • localOnly - 不会使用外部源。结果仅来自快速本地源（无论源设置如何），例如缓存、hosts 文件、IP 地址字面量解析等。
    • cacheUsage string (可选) - 指示可以使用哪些 DNS 缓存条目（如果有）来提供响应。以下值之一：
      • allowed (默认) - 结果可能来自主机缓存（如果非陈旧）。
      • staleAllowed - 结果可能来自主机缓存（即使陈旧，也按过期或网络更改）。
      • disallowed - 结果不会来自主机缓存。
    • secureDnsPolicy string (可选) - 控制此请求的解析器的安全 DNS 行为。以下值之一：
      • allow (默认)
      • disable

返回 Promise<ResolvedHost> - 以 host 的解析 IP 地址解析。

此方法将从 默认会话解析主机。要从其他会话解析主机，请使用 ses.resolveHost()。

属性​

net.online 只读​

一个 boolean 属性。当前是否有互联网连接。

返回 false 是用户无法连接到远程站点的强烈指标。然而，返回 true 并不确定；即使某个连接已建立，也不能确定连接到某个特定远程站点的尝试是否会成功。