El protocol WebSocket és una tecnologia clau per a la comunicació bidireccional i en temps real a la web. A diferència de les peticions HTTP tradicionals, que segueixen un model de consulta i resposta unidireccional, una connexió WebSocket manté un canal obert de manera permanent entre el client i el servidor. Això permet la transmissió instantània de dades en ambdues direccions sense la sobrecàrrega que suposa obrir una nova connexió per a cada intercanvi. El Client de prova WebSocket és una eina dissenyada per a desenvolupadors, enginyers d'integració, personal de control de qualitat (QA) i operacions (Ops) que necessiten connectar-se manualment a un punt final WebSocket accessible públicament, enviar missatges de text i analitzar el comportament de la connexió.
Funcionament i gestió de la connexió
L'establiment d'una connexió WebSocket comença sempre amb una sol·licitud d'actualització de protocol (coneguda com a handshake) des del navegador cap al servidor. La connexió al servidor WebSocket només s'inicia quan seleccioneu "Connecta't". Durant aquest procés de negociació, l'eina mostra l'estat de transició mitjançant el missatge "S'està connectant a ‹address›...".
Si el procés es completa correctament, s'estableix un canal actiu i es mostra el missatge "Connectat a ‹address›." al registre d'esdeveniments. No obstant això, el cicle de vida de la connexió pot veure's afectat per limitacions de temps o errors de xarxa:
- Temps d'espera esgotat: Si el servidor no respon o no obre la connexió en un interval de 10 segons, el client desisteix i mostra el missatge "El servidor no va obrir la connexió en 10 segons.".
- Errors de connexió: Si l'intent de connexió falla de manera immediata o durant la negociació, es mostra l'advertiment "La connexió ha fallat. Comproveu l'adreça, el certificat, la disponibilitat del servidor i les regles d'accés al navegador.".
Requisits de les adreces i protocols de seguretat
Per iniciar una connexió, cal introduir una adreça que compleixi estrictament amb els esquemes de xarxa definits per a aquest protocol. L'eina només admet els esquemes ws:// (WebSocket no segur) i wss:// (WebSocket segur sobre TLS/SSL). Si s'introdueix un esquema diferent, es mostrarà el missatge "Utilitzeu una adreça ws:// o wss://.".
Si l'adreça introduïda no conté una estructura vàlida o està incompleta, el client de prova retornarà l'error "Introduïu una adreça WebSocket completa, com ara wss://example.com/socket.". A més, per garantir l'estabilitat del navegador i evitar desbordaments de memòria, l'adreça de connexió té un límit de longitud màxim de 2.048 caràcters; si se supera aquest límit, es mostra el missatge "Aquesta adreça és inusualment llarga. Manteniu-lo sota els caràcters 2,048.".
La diferència entre ws:// i wss:// és equivalent a la que existeix entre HTTP i HTTPS. L'ús de wss:// garanteix que el trànsit de dades estigui xifrat, protegint la comunicació contra la intercepció de tercers i evitant problemes de seguretat en entorns de producció.
Enviament de missatges i límits de dades
Una vegada establerta la connexió, l'usuari pot enviar missatges de text de manera individual. Per transmetre el text introduït al servidor, es pot fer clic al botó corresponent o utilitzar les tecles de drecera Ctrl+Enter o Command+Enter.
L'enviament de dades està subjecte a les següents regles i restriccions tècniques:
- Estat de connexió requerit: No és possible enviar dades si no hi ha una connexió activa. Si s'intenta realitzar aquesta acció, el client mostrarà el missatge "Connecta't abans d'enviar un missatge.".
- Mida màxima del missatge: El camp de text admet missatges amb una longitud màxima de 100.000 caràcters. Si el text supera aquest límit, es bloqueja l'enviament i es mostra l'avís "Aquest missatge és inusualment gran. Manteniu-lo sota els caràcters 100,000.".
Interpretació del registre de missatges i esdeveniments
El client disposa d'un registre cronològic detallat que recull tota l'activitat de la sessió. Cada entrada del registre es classifica segons la seva naturalesa: "Enviat" per a les dades que surten del client, "Rebut" per a les que arriben del servidor, o "Esdeveniment" per als canvis d'estat de la connexió.
Dins d'aquest registre, es diferencien els tipus de missatges rebuts:
- Text: Identifica els missatges de text pla o estructurat (com JSON).
- Missatge binari: Identifica les dades binàries rebudes, mostrant la seva mida en bytes amb el format "bytes".
Per tal de mantenir la pàgina web totalment interactiva i evitar problemes de rendiment per acumulació de dades, el registre de missatges té un límit de retenció de 500 entrades. Quan se supera aquest llindar, es mostra el missatge "‹count› S'han eliminat les entrades de registre anteriors per mantenir aquesta pàgina sensible.". Així mateix, per evitar que missatges extremadament llargs bloquegin la interfície, cada entrada del registre mostra un màxim de 20,000 caràcters; si el missatge és més llarg, es retalla i s'afegeix l'indicador "‹count› s'amaguen més caràcters en aquesta previsualització.".
L'usuari pot utilitzar l'opció d'esborrar el registre per netejar la pantalla. Aquesta acció només elimina visualment les entrades mostrades, però no tanca la connexió activa ni reinicia els comptadors de missatges enviats i rebuts.
Tancament de la connexió i codis d'estat
Quan la connexió es tanca, ja sigui per decisió de l'usuari o per ordre del servidor, el client registra l'esdeveniment amb el format "Tancat amb el codi ‹code› (‹clean›). Motiu: ‹reason›". El tancament pot ser classificat com a "net" (si s'ha completat correctament la seqüència de tancament del protocol) o "no net" (si s'ha produït una caiguda abrupta de la connexió).
El codi numèric de tancament indica el motiu pel qual s'ha finalitzat la connexió. Si el servidor no proporciona una explicació textual del tancament, es mostra el text per defecte "No s'ha donat cap motiu".
Privadesa i processament de dades
La privadesa de les dades és un aspecte fonamental durant les proves de desenvolupament. No es carrega res a BroBroGo ni es desa amb aquesta pàgina. La vostra adreça i missatges van directament des del vostre navegador al servidor WebSocket que trieu. Atès que tot el processament es realitza localment en el navegador de l'usuari, cal tenir en compte que l'eina està subjecta a les mateixes regles de seguretat i restriccions d'accés que s'apliquen a qualsevol aplicació web estàndard.
Preguntes freqüents
Quines dades de WebSocket puc inspeccionar aquí?
Podeu veure cada missatge de text o binari exposat pel vostre navegador, la seva direcció, hora i mida, a més del codi de tancament final, el motiu i l'estat de tancament net. Les pàgines del navegador no poden exposar fragments a nivell de xarxa ni marcs de control Ping i Pong.
Per què falla una connexió fins i tot quan l'adreça funciona en un altre lloc?
En una pàgina segura, el navegador pot requerir wss://. El servidor també ha d'acceptar connexions de navegador i l'origen de la pàgina. Aquest client no pot afegir capçaleres personalitzades d'enllaç, evitar errors de certificat ni anul·lar les regles d'accés del servidor.
Puc provar amb dades de producció o sensibles?
Utilitzeu dades sintètiques sempre que sigui possible. Elimina noms, detalls del compte, registres legals, informació financera i informació de salut abans d'enviar-los. Els missatges van al servidor que trieu, les regles de registre i retenció del qual estan fora del control d'aquesta pàgina.