Présentation du Client de test WebSocket
Le Client de test WebSocket est un outil conçu pour interagir directement avec des serveurs WebSocket. Il permet de se connecter à un serveur, d'envoyer des messages texte et de consulter un journal chronologique complet de tous les messages envoyés et reçus.
Cet outil affiche également l'état de la connexion en temps réel, notamment lors de l'ouverture et de la fermeture de celle-ci. En cas de déconnexion, il fournit des détails précis sur le code de fermeture du WebSocket ainsi que la raison de la fermeture fournie par le serveur.
Public cible et cas d'usage
Cet outil s'adresse à différents professionnels du secteur technologique ayant besoin de tester manuellement un point de terminaison WebSocket accessible publiquement. Il est particulièrement utile pour:
- Les développeurs qui travaillent avec des API en temps réel.
- Les ingénieurs d'intégration.
- Le personnel d'assurance qualité (QA).
- Le personnel des opérations (Ops).
Toute personne ayant besoin d'envoyer des messages texte à un WebSocket et d'observer les journaux de connexion, de message et de fermeture trouvera ici un outil adapté à ses besoins.
Configuration des entrées de l'outil
Pour utiliser le client de test, deux champs de saisie principaux sont mis à disposition:
- Adresse WebSocket: Vous devez saisir une adresse complète utilisant le protocole
ws://ouwss://. La connexion avec le serveur ne démarre que lorsque vous sélectionnez le bouton Se connecter. Cette adresse peut comporter un maximum de 2 048 caractères. - Message: Ce champ vous permet de saisir le texte à envoyer au serveur WebSocket. Vous pouvez envoyer un message texte à la fois. Pour valider et envoyer votre saisie, vous pouvez cliquer sur le bouton d'envoi ou utiliser les raccourcis clavier
Ctrl+EnterouCommand+Enter. Les messages individuels sont limités à une taille maximale de 100 000 caractères.
Analyse des résultats et du journal des messages
Une fois la connexion établie, l'outil affiche plusieurs indicateurs de performance et un journal d'activité détaillé:
- Compteurs d'activité: L'interface affiche en temps réel le nombre total de messages dans les compteurs Envoyé et Reçu.
- Code de fermeture: En fin de session, le code numérique indiquant la raison de la fermeture de la connexion WebSocket est affiché.
- Journal des messages: Il s'agit d'une liste chronologique des événements et des messages échangés. Chaque entrée du journal est catégorisée de la manière suivante:
- Envoyé: Indique qu'un message a été expédié depuis le client.
- Reçu: Indique qu'un message a été reçu par le client.
- Événement: Signale un événement lié à l'état de la connexion.
- Texte: Identifie un message au format texte.
- Message binaire: Identifie un message binaire, suivi de sa taille spécifiée en octets.
- Connecté à
‹address›: Ce message d'événement s'affiche lorsque la connexion est ouverte avec succès. - Fermé avec le code
‹code›(‹clean›). Raison:‹reason›: Cet événement apparaît à la fermeture de la connexion. Il indique le code de fermeture, l'état de la fermeture (qui peut être nettoyer ou pas propre) et la raison fournie par le serveur. Si le serveur ne fournit aucune explication, la mention Aucune raison fournie est affichée.
Règles de fonctionnement et limites techniques
Pour garantir la stabilité de l'application et respecter les standards des navigateurs, plusieurs règles et limites s'appliquent:
- Gestion du journal: Le journal des messages conserve un maximum de 500 entrées. Si ce seuil est dépassé, le message « Les anciennes entrées de journal
‹count›ont été supprimées pour que cette page reste réactive. » apparaît. De plus, chaque entrée de journal affiche un maximum de 20 000 caractères. Au-delà, le message est tronqué et la mention «‹count›davantage de caractères sont masqués dans cet aperçu. » est affichée. - Effacement du journal: L'action d'effacer le journal supprime uniquement les lignes affichées à l'écran. Cela ne ferme pas la connexion active et ne réinitialise pas les compteurs de messages envoyés et reçus.
- Limitations du navigateur: Cet outil fonctionne dans le cadre des API standards du navigateur. Par conséquent, il ne peut pas ajouter d'en-têtes de prise de contact personnalisés, contourner les erreurs de certificat ou remplacer les règles d'accès définies par le serveur. De plus, il est impossible d'exposer les fragments au niveau du réseau ou les trames de contrôle de type Ping et Pong.
Gestion des erreurs et messages d'avertissement
Le client de test intègre des validations strictes pour vous guider lors de vos tests:
- Erreurs d'adresse:
- Si l'adresse saisie n'est pas complète, l'outil affiche: « Entrez une adresse WebSocket complète telle que wss://example.com/socket. ».
- Si vous utilisez un protocole autre que
ws://ouwss://, le message suivant apparaît: « Utilisez une adresse ws:// ou wss://. ». - Si l'adresse dépasse 2 048 caractères, l'outil affiche: « Cette adresse est inhabituellement longue. Conservez-le sous les caractères 2,048. ».
- Erreurs de connexion:
- Pendant la tentative de connexion, l'outil affiche « Connexion à
‹address›… ». - Si le serveur ne répond pas dans un délai de 10 secondes, le message « Le serveur n'a pas ouvert la connexion dans les secondes 10. » s'affiche.
- En cas d'échec de la connexion, l'outil affiche: « La connexion a échoué. Vérifiez l'adresse, le certificat, la disponibilité du serveur et les règles d'accès au navigateur. ».
- Pendant la tentative de connexion, l'outil affiche « Connexion à
- Erreurs d'envoi de message:
- Si vous tentez d'envoyer un message sans être connecté, l'outil affiche: « Connectez-vous avant d'envoyer un message. ».
- Si votre message dépasse 100 000 caractères, le message suivant apparaît: « Ce message est inhabituellement volumineux. Conservez-le sous les caractères 100,000. ».
Confidentialité et traitement des données
La confidentialité de vos données est préservée lors de l'utilisation de cet outil. Rien n'est téléchargé sur BroBroGo ni enregistré par cette page. L'adresse du serveur ainsi que vos messages transitent directement depuis votre navigateur vers le serveur WebSocket que vous avez vous-même choisi.
FAQ (Foire aux questions)
Quelles données WebSocket puis-je inspecter ici?
Vous pouvez voir chaque message texte ou binaire exposé par votre navigateur, sa direction, son heure et sa taille, ainsi que le code de fermeture final, la raison et l'état de fermeture propre. Les pages du navigateur ne peuvent pas exposer les fragments au niveau du réseau ou les trames de contrôle Ping et Pong.
Pourquoi une connexion échoue-t-elle même lorsque l’adresse fonctionne ailleurs?
Sur une page sécurisée, le navigateur peut exiger wss://. Le serveur doit également accepter les connexions du navigateur et l'origine de la page. Ce client ne peut pas ajouter d'en-têtes de prise de contact personnalisés, contourner les erreurs de certificat ou remplacer les règles d'accès du serveur.
Puis-je tester avec des données de production ou sensibles?
Utilisez des données synthétiques autant que possible. Supprimez les noms, les détails du compte, les dossiers juridiques, les informations financières et les informations de santé avant l'envoi. Les messages sont envoyés au serveur que vous choisissez, dont les règles de journalisation et de conservation échappent au contrôle de cette page.