Was ist SockJS?

SockJS ist eine Open-Source-JavaScript-Bibliothek, die eine WebSocket-ähnliche API bereitstellt und transparent auf alternative Transporte zurückfällt, wenn WebSocket nicht verfügbar ist. Sie wurde für Umgebungen entwickelt, in denen WebSocket-Verbindungen blockiert werden – beispielsweise durch Unternehmens-Firewalls, ältere Browser oder Load Balancer, die keine Verbindungsupgrades unterstützen. SockJS verhandelt automatisch den besten verfügbaren Transport und wählt aus WebSocket, HTTP-Streaming, HTTP-Long-Polling und mehreren anderen Mechanismen.

SockJS erfordert eine kompatible serverseitige Bibliothek (wie SockJS-Node oder Spring's SockJS-Unterstützung) und verwendet sein eigenes Subprotokoll, daher kann es sich nicht mit einem einfachen WebSocket-Endpunkt verbinden.

Werkzeugbeschreibung

Dieses Werkzeug bietet einen browserbasierten SockJS-Client. Geben Sie die URL eines SockJS-Server-Endpunkts ein, verbinden Sie sich, verfassen Sie Textnachrichten und beobachten Sie den gesamten Datenverkehr in einem zeitgestempelten Nachrichtenprotokoll. Der aktive Transportname (z. B. websocket, xhr-streaming, xhr-polling) wird in Echtzeit angezeigt, sodass Sie sehen können, welchen Fallback-Mechanismus die Bibliothek ausgewählt hat.

Funktionen

  • Automatische Transportverhandlung — verbindet sich mit dem besten verfügbaren Transport und zeigt an, welcher ausgewählt wurde.
  • Live-Nachrichtenprotokoll — alle eingehenden Nachrichten und Verbindungsereignisse werden mit Zeitstempeln erfasst, um eine einfache Überprüfung zu ermöglichen.
  • Text- und JSON-Modi — schreiben Sie Nutzlasten als Klartext oder strukturiertes JSON mit Syntaxhervorhebung und Validierung.

Optionen erklärt

Server-URL — die HTTP(S)-URL des SockJS-Endpunkts (z. B. https://example.com/sockjs). Fügen Sie nicht /websocket oder ein Transportsuffix an; SockJS verwaltet die Pfadverhandlung intern.

Transport — wird im Ausgabebereich angezeigt, nachdem die Verbindung geöffnet wird. Häufige Werte sind websocket (direktes Upgrade erfolgreich), xhr-streaming (Streaming über XHR) und xhr-polling (traditionelles Long-Poll). Dieses Feld bleibt leer, bis die Verbindung hergestellt ist.

Datentyp — wechseln Sie zwischen Text- und JSON-Kompositionsmodi. Der JSON-Modus validiert die Nutzlast vor dem Senden.

Automatisches Scrollen — hält das Nachrichtenprotokoll an den neuesten Eintrag angeheftet.

Funktionsweise

Der Client verwendet die SockJS-JavaScript-Bibliothek, um eine Verbindung zum Zielserver zu öffnen. SockJS führt eine Informationsanfrage an den Server durch, um zu ermitteln, welche Transporte unterstützt werden, und verhandelt dann die beste Option. Nach der Verbindung leitet das Werkzeug alle ausgehenden Nachrichten über die SockJS-Methode send weiter und protokolliert jedes onmessage-Ereignis, das vom Server zurückgegeben wird.

Tipps

  • SockJS-Server stellen ihren Endpunkt normalerweise unter einem Pfad wie /sockjs oder /ws bereit. Überprüfen Sie die Serverdokumentation für die richtige Basis-URL.
  • Wenn der Transport xhr-polling statt websocket anzeigt, blockiert der Server oder Proxy möglicherweise WebSocket-Upgrades.
  • SockJS ist nicht mit einfachen WebSocket-Endpunkten kompatibel. Verwenden Sie den WebSocket-Test-Client für Standard-WebSocket-Server.