0Pricing
WebSockets & Realtime Systems Programming · Aula

Implementando a lógica no lado do servidor

Escreva código para criar um servidor WebSocket, aguardar conexões e tratar eventos básicos.

Implementando a lógica no lado do servidor é uma aula grátis de WebSockets & Realtime Systems Programming no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de WebSockets & Realtime Systems Programming, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de WebSockets & Realtime Systems Programming inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

Server Logic Unveiled

Welcome back! In the previous lesson, we set up our Node.js project. Now, let's dive into building the actual server logic for our WebSocket application.

We'll learn how to create a WebSocket server, listen for incoming client connections, and handle basic events like receiving and sending messages.

Creating the WS Server

The first step is to create an instance of our WebSocket server. We'll use the ws library we installed earlier. It provides a WebSocket.Server class.

We need to specify a port for our server to listen on. Port 8080 is a common choice for development.

Try running this basic server setup:

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });

console.log('WebSocket server started on port 8080');

Listening for Connections

Our server is running, but it doesn't do much yet! The most fundamental event for a WebSocket server is 'connection'.

This event fires every time a new client successfully establishes a WebSocket connection with our server. The event handler receives a ws object, representing the individual client connection.

Let's add a handler to log when a client connects:

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });

wss.on('connection', function connection(ws) {
  console.log('Client connected!');
});

console.log('WebSocket server started on port 8080');

The Client WebSocket Object

When a client connects, the wss.on('connection') callback receives a ws object. This isn't the server itself, but an instance of WebSocket specific to that client.

  • It represents the communication channel with that single client.
  • We'll use this ws object to send messages to, and receive messages from, that particular client.

Think of it as a direct line to one person in a crowded room.

Handling Client Messages

Once a client is connected, it can send messages to our server. We need to listen for these messages using the 'message' event on the individual client's ws object.

The message handler receives the data sent by the client. For simplicity, we'll assume text messages for now.

Update your server to log any incoming messages:

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });

wss.on('connection', function connection(ws) {
  console.log('Client connected!');

  ws.on('message', function incoming(message) {
    console.log('Received: %s', message);
  });
});

console.log('WebSocket server started on port 8080');

Sending Data Back to Client

A key aspect of WebSockets is bidirectional communication. Not only can clients send messages to the server, but the server can also send messages back to specific clients.

We use the ws.send() method on the client's WebSocket object to send data. Let's create a simple 'echo' server that sends back whatever it receives!

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });

wss.on('connection', function connection(ws) {
  console.log('Client connected!');

  ws.on('message', function incoming(message) {
    console.log('Received: %s', message);
    ws.send(`Server received: ${message}`); // Echo back!
  });
});

console.log('WebSocket server started on port 8080');

Handling Client Disconnections

Clients won't stay connected forever. They might close their browser tab, lose internet, or deliberately disconnect. It's crucial to handle these disconnections gracefully.

The 'close' event on the client's ws object tells us when a client has disconnected. This is useful for cleanup or logging.

Add a 'close' event handler to your server:

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });

wss.on('connection', function connection(ws) {
  console.log('Client connected!');

  ws.on('message', function incoming(message) {
    console.log('Received: %s', message);
    ws.send(`Server received: ${message}`);
  });

  ws.on('close', function close() {
    console.log('Client disconnected!');
  });
});

console.log('WebSocket server started on port 8080');

Dealing with Errors

Errors can occur at various stages ��� network issues, malformed messages, or server problems. It's good practice to include error handling.

  • Client-specific errors: Use ws.on('error', ...) for issues related to a single client connection.
  • Server-wide errors: Use wss.on('error', ...) for problems affecting the entire WebSocket server.

Let's add basic error logging to our server:

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });

wss.on('connection', function connection(ws) {
  console.log('Client connected!');

  ws.on('message', function incoming(message) {
    console.log('Received: %s', message);
    ws.send(`Server received: ${message}`);
  });

  ws.on('close', function close() {
    console.log('Client disconnected!');
  });

  ws.on('error', function error(err) {
    console.error('Client WS Error:', err.message);
  });
});

wss.on('error', function serverError(err) {
  console.error('Server WS Error:', err.message);
});

console.log('WebSocket server started on port 8080');

Full Basic Server Example

You've now learned how to set up a WebSocket server, handle new connections, listen for incoming messages, send responses, and manage disconnections and errors.

This complete example brings all those concepts together, forming a robust foundation for your WebSocket applications.

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });

wss.on('connection', function connection(ws) {
  console.log('Client connected!');

  ws.on('message', function incoming(message) {
    console.log(`Received from client: ${message}`);
    ws.send(`Echo: ${message}`); // Send message back to the same client
  });

  ws.on('close', function close() {
    console.log('Client disconnected!');
  });

  ws.on('error', function error(err) {
    console.error('Client connection error:', err);
  });
});

wss.on('listening', () => {
  console.log('WebSocket server is listening on port 8080');
});

wss.on('error', function serverError(err) {
  console.error('WebSocket server error:', err);
});

Server Logic Quiz

Which event handler is used on the server instance (wss) to detect when a new client connects?

Recap & Next Steps

Great work! You've successfully implemented the core server-side logic for a WebSocket application.

  • You learned to create a WebSocket.Server instance.
  • You handled 'connection', 'message', 'close', and 'error' events.
  • You can now send messages back to individual connected clients using ws.send().

Next, we'll explore how to send messages to ALL connected clients, a crucial feature for chat applications and other broadcast scenarios!

Perguntas Frequentes

A aula “Implementando a lógica no lado do servidor” é grátis?

Sim — o texto completo de “Implementando a lógica no lado do servidor” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de WebSockets & Realtime Systems Programming, atualize para CoddyKit PRO. O curso de WebSockets & Realtime Systems Programming inclui 4 aulas no total.

O que vou aprender em “Implementando a lógica no lado do servidor”?

Escreva código para criar um servidor WebSocket, aguardar conexões e tratar eventos básicos. Você pratica WebSockets & Realtime Systems Programming com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar WebSockets & Realtime Systems Programming?

Nenhuma experiência prévia é necessária. WebSockets & Realtime Systems Programming no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Implementando a lógica no lado do servidor”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de WebSockets & Realtime Systems Programming?

Sim. Cada aula de WebSockets & Realtime Systems Programming inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Configurando um projeto Node.js
  2. Implementando a lógica no lado do servidor
  3. Transmitindo mensagens aos clientes
  4. Gerenciando salas e canais
← Voltar para WebSockets & Realtime Systems Programming