Skip to main content

net

Émet des requêtes HTTP/HTTPS à l'aide de la bibliothèque réseau natif de Chromium

Processus : Main

Le module net est une API côté client pour émettre des requêtes HTTP(S). Il est semblable aux modules HTTP et HTTPS de Node.js, mais utilise la bibliothèque réseau natif de Chromium au lieu de l'implémentation de Node.js, offrant un meilleur support pour les proxy web. It also supports checking network status.

Voici une liste non exhaustive de pourquoi vous devriez utiliser le module net plutôt que les modules natifs de Node.js :

  • Gestion automatique de la configuration de proxy système, support du protocole wpad et les fichiers de configuration de proxy pac.
  • Tunnel automatique des requêtes HTTPS.
  • Prise en charge de l'authentification proxy en utilisant basic, digest, NTLM, Kerberos ou en négociant des schémas d'authentification.
  • Prise en charge des proxy de surveillance du trafic: Proxy de type Fiddler utilisés pour le contrôle et la surveillance des accès.

Les composants de l'API (y compris les classes, méthodes, propriétés et noms d'événements) sont similaires à ceux utilisés dans Node.js.

Exemple d'utilisation :

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()
})

L'API net ne peut être utilisée qu'après que l'application ait émit un événement ready. Trying to use the module before the ready event will throw an error.

Méthodes

Le module net dispose des méthodes suivantes :

net.request(options)

  • options (ClientRequestConstructorOptions | String) - Les options du constructeur ClientRequest.

Retourne ClientRequest

Créer une instance de ClientRequest avec les options founies qui sont directement transmis au constructor de ClientRequest. La méthode net.request doit être utilisée pour émettre des requêtes HTTP sécurisés et non sécurisés selon le schéma de protocole spécifié dans l'objet options.

net.isOnline()

Returns Boolean - Whether there is currently internet connection.

A return value of false is a pretty strong indicator that the user won't be able to connect to remote sites. However, a return value of true is inconclusive; even if some link is up, it is uncertain whether a particular connection attempt to a particular remote site will be successful.

Propriétés

net.online Lecture seule

Une propriété Boolean. Whether there is currently internet connection.

A return value of false is a pretty strong indicator that the user won't be able to connect to remote sites. However, a return value of true is inconclusive; even if some link is up, it is uncertain whether a particular connection attempt to a particular remote site will be successful.