Comment utiliser WebSocket dans Node.js

Node.js facilite l'utilisation des WebSockets. Ce guide explique comment les intégrer et les utiliser.

Louis Dupont

Louis Dupont

5 June 2025

Comment utiliser WebSocket dans Node.js

Les WebSockets ont révolutionné la communication en temps réel sur le web, permettant des canaux de communication bidirectionnels et full-duplex via une seule connexion TCP. Avec Node.js, un environnement d'exécution JavaScript puissant, exploiter les capacités des WebSockets devient encore plus accessible et efficace.

Dans ce guide, nous allons parcourir le processus d'intégration et d'utilisation des WebSockets dans Node.js.

💡
Pour le débogage des services WebSocket, utilisez Apidog, un excellent outil de débogage d'API offrant une interface conviviale qui permet une simulation facile des requêtes, l'observation des échanges de messages et la modification du contenu, assurant ainsi un fonctionnement fluide pour les applications basées sur WebSocket.
button

Qu'est-ce que WebSocket ?

Avant de plonger dans l'implémentation, il est crucial de comprendre ce que sont les WebSockets et en quoi ils diffèrent des requêtes HTTP traditionnelles. Contrairement à HTTP, qui suit un modèle requête-réponse, les WebSockets fournissent des connexions persistantes entre les clients et les serveurs, permettant un échange de données en temps réel et à faible latence.

Cela les rend idéaux pour les applications nécessitant des mises à jour instantanées, telles que les applications de chat, les jeux multijoueurs et les outils collaboratifs.

Websocket API

Cas d'utilisation de WebSocket

WebSocket est particulièrement pertinent dans les scénarios suivants :

Configuration d'un projet Node.js

Pour commencer, assurez-vous que Node.js est installé sur votre système. Vous pouvez vérifier votre installation en exécutant node -v dans votre terminal.

Une fois confirmé, créez un nouveau répertoire pour votre projet et naviguez-y.

mkdir websocket-example
cd websocket-example

Initialisez un nouveau projet Node.js en utilisant npm :

npm init -y

Cette commande crée un fichier package.json avec les paramètres par défaut. Ensuite, installez le package ws, une bibliothèque WebSocket populaire pour Node.js :

npm install ws

Implémentation d'un serveur WebSocket

Avec le projet configuré, créons un serveur WebSocket en utilisant la bibliothèque ws. Créez un nouveau fichier nommé server.js dans le répertoire de votre projet et ajoutez le code suivant :

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });
wss.on('connection', function connection(ws) {console.log('A new client connected.');
  ws.on('message', function incoming(message) {console.log('Received: %s', message);
  });
  ws.send('Welcome to the WebSocket server!');
});

Ce code initialise un serveur WebSocket sur le port 8080 et écoute les connexions entrantes. Lors de la connexion, il enregistre un message et configure un écouteur d'événements pour les messages entrants. Il envoie également un message de bienvenue au client.

Création d'un client WebSocket

Maintenant, créons un simple client WebSocket pour nous connecter à notre serveur. Créez un nouveau fichier nommé client.js dans le répertoire du projet et ajoutez le code suivant :

const WebSocket = require('ws');

const ws = new WebSocket('ws://localhost:8080');
ws.on('open', function open() {console.log('Connected to the server.');
});
ws.on('message', function incoming(data) {console.log('Received from server: %s', data);
});

Ce code établit une connexion WebSocket à ws://``localhost:8080 et enregistre un message lors de la connexion réussie. Il configure également un écouteur d'événements pour recevoir des messages du serveur.

Exécution de l'application

Avant d'exécuter l'application, assurez-vous que le serveur WebSocket (server.js) est en cours d'exécution. Vous pouvez le démarrer en exécutant :

node server.js

Une fois le serveur en cours d'exécution, exécutez le script client (client.js) dans une autre fenêtre de terminal :

node client.js

Vous devriez voir des messages indiquant des connexions réussies du serveur et du client.

Apidog : Rationalisation des tests d'API WebSocket

Websocket in Apidog

Au lieu de Node.js, envisagez d'utiliser Apidog, un excellent outil similaire à Postman pour les tests d'API polyvalents. Apidog prend en charge les tests d'API WebSocket, offrant des interfaces conviviales pour la création, la gestion et le test des API WebSocket.

button

Explore more

Comment utiliser Deepseek R1 en local avec Cursor

Comment utiliser Deepseek R1 en local avec Cursor

Apprenez à configurer DeepSeek R1 local avec Cursor IDE pour une aide au codage IA privée et économique.

4 June 2025

Comment exécuter Gemma 3n sur Android ?

Comment exécuter Gemma 3n sur Android ?

Apprenez à installer et exécuter Gemma 3n sur Android via Google AI Edge Gallery.

3 June 2025

Comment utiliser Claude Code avec GitHub Actions

Comment utiliser Claude Code avec GitHub Actions

Découvrez Claude Code avec GitHub Actions : revues de code, corrections de bugs, implémentation de fonctionnalités. Tutoriel pour développeurs.

29 May 2025

Pratiquez le Design-first d'API dans Apidog

Découvrez une manière plus simple de créer et utiliser des API