net
使用 Chromium 的原生网络库发送 HTTP/HTTPS 请求
net
模块是一个客户端 API,用于发送 HTTP(S) 请求。它类似于 Node.js 的 HTTP 和 HTTPS 模块,但使用 Chromium 的原生网络库而不是 Node.js 实现,提供对 Web 代理的更好支持。它还支持检查网络状态。
以下是您可能考虑使用 net
模块而不是原生 Node.js 模块的一些非详尽列表
- 自动管理系统代理配置,支持 wpad 协议和代理 pac 配置文件。
- 自动隧道化 HTTPS 请求。
- 支持使用基本、摘要、NTLM、Kerberos 或协商身份验证方案对代理进行身份验证。
- 支持流量监控代理:用于访问控制和监控的 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()
})
只有在应用程序发出 ready
事件后才能使用 net
API。尝试在 ready
事件之前使用该模块将抛出错误。
方法
net
模块具有以下方法
net.request(options)
使用提供的 options
创建 ClientRequest
实例,这些选项将直接转发到 ClientRequest
构造函数。net.request
方法将用于根据 options
对象中指定的协议方案发出安全和不安全的 HTTP 请求。
net.fetch(input[, init])
input
string | GlobalRequestinit
RequestInit & { bypassCustomProtocolHandlers?: boolean } (可选)
返回 Promise<GlobalResponse>
- 请参阅 Response.
发送请求,类似于渲染器中 fetch()
的工作方式,使用 Chrome 的网络堆栈。这与使用 Node.js 的 HTTP 堆栈的 Node 的 fetch()
不同。
示例
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 - 要解析的主机名。
返回 Promise<ResolvedHost> - 使用 host
的解析 IP 地址解析。
此方法将从 默认会话 解析主机。要从另一个会话解析主机,请使用 ses.resolveHost().
属性
net.online
只读
boolean
属性。当前是否存在互联网连接。
false
的返回值强烈表明用户将无法连接到远程站点。但是,true
的返回值是不确定的;即使某些链接已开启,也无法确定对特定远程站点的特定连接尝试是否会成功。