Fundamentos de WebSocket en el navegador
Abra conexiones WebSocket, envíe mensajes y gestione eventos con la API WebSocket nativa.
Fundamentos de WebSocket en el navegador es una lección gratuita de React Academy en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de React Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de React Academy incluye 4 lecciones en total.
¿Qué es WebSocket?
WebSocket es un protocolo que proporciona comunicación dúplex completa a través de una única conexión TCP. A diferencia de HTTP, la conexión permanece abierta, lo que permite al servidor enviar datos al cliente en cualquier momento.
Apertura de una conexión
Cree un objeto WebSocket con una URL ws:// o wss://. La conexión se abre de forma asíncrona.
const ws = new WebSocket('wss://api.example.com/ws');
ws.onopen = () => {
console.log('Connection established');
};Envío de mensajes
Use ws.send() para enviar datos. Puede enviar cadenas o datos binarios (ArrayBuffer, Blob). Codifique los objetos en JSON antes de enviarlos.
ws.onopen = () => {
ws.send(JSON.stringify({ type: 'join', room: 'general' }));
ws.send('Hello, server!');
};Recepción de mensajes
El evento onmessage se dispara cada vez que el servidor envía datos. Los datos se encuentran en event.data como una cadena o un valor binario.
ws.onmessage = (event) => {
const data = JSON.parse(event.data);
console.log('Received:', data);
};Gestión de errores y cierre
Gestione los eventos onerror y onclose. El evento de cierre incluye un código y un motivo que explican por qué terminó la conexión.
ws.onerror = (error) => {
console.error('WebSocket error:', error);
};
ws.onclose = (event) => {
console.log(`Closed: ${event.code} ${event.reason}`);
if (event.wasClean) {
console.log('Clean disconnect');
} else {
console.log('Connection lost — will retry');
}
};Códigos de cierre
Códigos de cierre estándar de WebSocket: 1000 = normal, 1001 = cierre por desconexión, 1006 = anormal (sin trama de cierre), 1008 = incumplimiento de la política.
readyState
ws.readyState indica el estado actual de la conexión: CONNECTING (0), OPEN (1), CLOSING (2) o CLOSED (3). Compruébelo siempre antes de enviar.
function sendSafely(ws, data) {
if (ws.readyState === WebSocket.OPEN) {
ws.send(JSON.stringify(data));
} else {
console.warn('WebSocket not open, dropping message');
}
}Cierre de la conexión
Llame a ws.close(code, reason) para iniciar un cierre limpio. El servidor recibe la trama de cierre y puede responder con la suya.
// Normal close
ws.close(1000, 'User logged out');
// Close from a cleanup effect
return () => ws.close();Datos binarios
Establezca ws.binaryType = 'arraybuffer' (o 'blob') para recibir mensajes binarios. Resulta útil para audio, imágenes o protocolos personalizados.
ws.binaryType = 'arraybuffer';
ws.onmessage = (event) => {
if (event.data instanceof ArrayBuffer) {
const view = new Uint8Array(event.data);
console.log('Binary message, bytes:', view.length);
} else {
console.log('Text message:', event.data);
}
};Heartbeat / ping-pong
La API de WebSocket del navegador no expone las tramas ping, pero puede implementar un heartbeat a nivel de aplicación: envíe un mensaje ping cada N segundos y espere una respuesta pong.
function startHeartbeat(ws) {
return setInterval(() => {
if (ws.readyState === WebSocket.OPEN) {
ws.send(JSON.stringify({ type: 'ping' }));
}
}, 30_000);
}WebSocket frente a Server-Sent Events
Use WebSocket para la comunicación bidireccional (chat, juegos). Use Server-Sent Events (SSE) para flujos únicamente del servidor al cliente (notificaciones, fuentes en directo); SSE funciona sobre HTTP estándar y se reconecta automáticamente.
Comprobación rápida
¿Qué valor de readyState de WebSocket indica que la conexión está abierta y lista para enviar?
Recapitulación
Cree conexiones con new WebSocket(url), envíe objetos convertidos a cadenas JSON mediante ws.send() y gestione los eventos onmessage, onerror y onclose. Compruebe readyState antes de enviar y cierre la conexión correctamente con ws.close(1000).
Preguntas frecuentes
¿La lección «Fundamentos de WebSocket en el navegador» es gratis?
Sí — el texto completo de «Fundamentos de WebSocket en el navegador» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de React Academy, actualiza a CoddyKit PRO. El curso de React Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Fundamentos de WebSocket en el navegador»?
Abra conexiones WebSocket, envíe mensajes y gestione eventos con la API WebSocket nativa. Practicas React Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar React Academy?
No se requiere experiencia previa. React Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «Fundamentos de WebSocket en el navegador»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de React Academy?
Sí. Cada lección de React Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Fundamentos de WebSocket en el navegador
- Utilizar Socket.IO con React
- Crear un componente de chat en tiempo real
- Reconexión, gestión de errores y limpieza