WebSocket
A WebSocket keeps a two-way connection between a web app and a server. Either side can send messages while it is open.
Another example
Two teammates edit one board. Each saved move reaches the other screen through the open connection.
Main parts
- 01Opening handshake
- 02Ready state
- 03Incoming message
- 04Outgoing message
- 05Close and app recovery
Use it when
Use it for chat, collaboration, or live events that need messages in both directions.
Do not use it when
Use a normal request for an occasional simple read. WebSocket has no built-in authentication, so your app must add access checks and recovery rules.
Name used in code
CONNECTING -> OPEN <-> messages -> CLOSING -> CLOSED Before you ship
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome: Design or review WebSocket for this system while keeping data correct, secure, and easy to operate. User context: Two teammates edit one board. Each saved move reaches the other screen through the open connection. Technical concept or control: WebSocket. Why it fits: Use it for chat, collaboration, or live events that need messages in both directions. Do not use it when: Use a normal request for an occasional simple read. WebSocket has no built-in authentication, so your app must add access checks and recovery rules. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): The standard covers only the listed scope. It does not choose the visual style, product decision, or Vibulary example. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
Check this request
Review the current use of WebSocket. Definition: A WebSocket keeps a two-way connection between a web app and a server. Either side can send messages while it is open. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.