WebSocket-Tester
Verbinde dich aus deinem Browser mit einem WebSocket-Server, sende Text-, JSON- oder Binärnachrichten und verfolge jeden Frame in einem Live-Protokoll mit Zeitstempeln und Größen. Automatisches Wiederverbinden und eine wiederholte Nachricht halten Langzeittests am Laufen.
Zuletzt aktualisiert:
Anleitung: WebSocket-Tester
- Gib die Server-URL ein, zum Beispiel wss://echo.websocket.org, und optional ein Subprotokoll.
- Klicke auf „Verbinden“. Der Status wird grün, sobald die Verbindung offen ist, und die ersten Nachrichten des Servers erscheinen im Protokoll.
- Gib eine Nachricht ein und klicke auf „Senden“ (oder drücke Strg+Eingabe). Wähle Text, JSON oder Binär (Hex) als Format.
- Verfolge das Protokoll: Gesendete Nachrichten sind mit einem Pfeil nach oben markiert, empfangene mit einem Pfeil nach unten und Verbindungsereignisse in Grau. Du kannst es jederzeit filtern oder exportieren.
- Aktiviere „Automatisch wiederverbinden“, damit die Verbindung nach dem Schließen durch den Server automatisch neu aufgebaut wird, und „Wiederholen“, um eine Nachricht per Timer zu senden.
WebSocket-Close-Codes
Wenn eine Verbindung endet, zeigt das Protokoll den Close-Code, den der Server gesendet (oder der Browser gesetzt) hat. Die häufigsten laut RFC 6455 und IANA-Registry:
| Code | Name | Was er meist bedeutet |
|---|---|---|
| 1000 | Normal Closure | Eine Seite hat die Verbindung absichtlich geschlossen. |
| 1001 | Going Away | Der Server fährt herunter oder startet neu, oder der Browser-Tab wurde geschlossen. |
| 1002 | Protocol Error | Ein Frame hat gegen das WebSocket-Protokoll verstoßen. |
| 1003 | Unsupported Data | Der Server kann diese Art von Nachricht nicht annehmen, zum Beispiel Binärdaten, wenn er Text erwartet. |
| 1005 | No Status Received | Der Close-Frame enthielt keinen Code. Wird vom Browser gesetzt, nie tatsächlich übertragen. |
| 1006 | Abnormal Closure | Die Verbindung ist abgebrochen oder wurde nie geöffnet: falsche URL, abgelehnte Verbindung, TLS- oder Proxy-Problem. Wird vom Browser gesetzt. |
| 1007 | Invalid Payload | Eine Textnachricht war kein gültiges UTF-8, oder die Daten entsprachen nicht dem, was der Server erwartet. |
| 1008 | Policy Violation | Der Server hat die Nachricht oder den Client abgelehnt, oft wegen einer Authentifizierungs- oder Origin-Prüfung. |
| 1009 | Message Too Big | Die Nachricht ist größer, als der Server erlaubt. |
| 1011 | Internal Error | Der Server ist auf einen unerwarteten Fehler gestoßen. |
| 1012 / 1013 | Service Restart / Try Again Later | Vorübergehend: Nach kurzer Wartezeit erneut verbinden (das automatische Wiederverbinden erledigt das für dich). |
| 4000–4999 | Anwendungscodes | Werden von der App oder Bibliothek definiert, mit der du kommunizierst; sieh in deren Dokumentation nach. |
Eine WebSocket-Verbindung debuggen
- Teste zuerst gegen einen Echo-Server. Wenn wss://echo.websocket.org funktioniert, dein Server aber nicht, liegt das Problem auf der Serverseite oder in der URL.
- Prüfe Pfad und Port. Viele Server lauschen auf einem bestimmten Pfad wie
/wsoder/socket; der Root-Pfad liefert oft einen Fehler. - Origin-Prüfungen. Server können Handshakes von unbekannten Origins mit HTTP 403 ablehnen, was der Browser als Close-Code 1006 meldet.
- Authentifizierung. Browser können dem Handshake keine eigenen Header hinzufügen; übergib ein Token daher im Query-String, in einem Cookie oder in der ersten Nachricht.
- Keep-alive. Proxys und Load Balancer schließen inaktive Verbindungen oft nach 30 bis 120 Sekunden. Nutze Nachricht wiederholen, um einen kleinen Ping zu senden und die Verbindung offen zu halten.
Häufige Fragen
Was ist ein WebSocket?
Ein WebSocket ist eine langlebige, bidirektionale Verbindung zwischen Browser und Server, die mit einer HTTP-Upgrade-Anfrage geöffnet wird und in RFC 6455 definiert ist. Anders als bei normalen HTTP-Anfragen können beide Seiten jederzeit Nachrichten senden, was WebSockets ideal für Chats, Live-Dashboards, Spiele und Benachrichtigungen macht.
Was ist der Unterschied zwischen ws:// und wss://?
wss:// ist WebSocket über TLS, das verschlüsselte Gegenstück zu https://. ws:// ist unverschlüsselt. Seiten, die wie diese über HTTPS ausgeliefert werden, können nur wss://-Verbindungen öffnen, außer zu localhost, was Browser für die Entwicklung meist erlauben.
Warum schlägt die Verbindung mit Code 1006 fehl?
1006 bedeutet, dass die Verbindung abnormal ohne Close-Frame beendet wurde, und Browser nennen den Grund nicht. Häufige Ursachen sind eine falsche URL oder ein falscher Port, ein Server, der den Origin-Header ablehnt, ein ungültiges TLS-Zertifikat, ein Proxy oder eine Firewall, die WebSockets blockiert, oder ein Server, der nicht läuft.
Kann ich eigene Header wie Authorization setzen?
Nein. Die WebSocket-API des Browsers erlaubt keine eigenen Header. Server akzeptieren ein Token meist im Query-String der URL (zum Beispiel ?token=...), in einem Cookie oder in der ersten Nachricht nach dem Verbinden. Manchmal wird dafür auch das Subprotokoll-Feld verwendet.
Unterstützt dieses Tool Socket.IO oder STOMP?
Es arbeitet mit reinen WebSocket-Frames. Socket.IO und STOMP setzen ein eigenes Nachrichtenformat darauf; du kannst also mit ihnen kommunizieren, indem du selbst korrekt formatierte Nachrichten sendest, aber dieses Tool implementiert diese Protokolle nicht automatisch.
Läuft mein Datenverkehr über FreeToolCabin?
Nein. Dein Browser verbindet sich direkt mit dem WebSocket-Server, den du eingibst. Nachrichten und Protokolle bleiben in diesem Tab; nur die URL und die letzten Nachrichten werden der Bequemlichkeit halber im lokalen Speicher deines Browsers gemerkt.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.