joewalnes/reconnecting-websocket

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

4319 stars · 953 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

A tiny JavaScript library (<600 bytes gzipped) that wraps the native WebSocket API to add automatic reconnection when the connection drops. It is a drop-in, API-compatible replacement for WebSocket with configurable reconnect intervals, backoff, and timeouts.

Use cases

• keep a websocket connection alive with automatic reconnect
• replace WebSocket with a reconnecting version
• handle dropped websocket connections in a browser app
• add exponential backoff to websocket reconnection
• maintain realtime data feed over websocket
• reconnect websocket after server restart

When to choose

• you want a minimal, zero-dependency drop-in replacement for WebSocket with auto-reconnect
• you need configurable reconnect intervals and backoff
• you want API compatibility so existing WebSocket code keeps working

When to avoid

• you need a full realtime client with pub/sub, channels, or fallback transports (consider Socket.IO or similar)
• you need reconnection logic with heartbeat/ping-pong health checks
• your project uses native WebSocket with custom reconnection already

Facets

library · maturity maintenance

websocket http-client web-development frontend browser websocket-reconnect drop-in-replacement tiny-library zero-dependency real-time nodejs javascript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="joewalnes/reconnecting-websocket")