Gorilla WebSocket is a Go implementation of the WebSocket protocol.
This fork adds fasthttp support to the latest version of gorilla/websocket.
The Gorilla WebSocket package provides a complete and tested implementation of the WebSocket protocol. The package API is stable.
go get github.com/fasthttp/websocket
But beware that this will fetch the latest commit of the master branch which is never purposely broken, but usually not considered stable anyway.
If you're using dep, just use dep ensure
to add
a specific version of fasthttp/websocket including all its transitive dependencies to
your project:
dep ensure -add github.com/fasthttp/websocket@v1.4.0
IMPORTANT: dep is only supported until version v1.4.0. In future versions will use Go modules.
The Gorilla WebSocket package passes the server tests in the Autobahn Test Suite using the application in the examples/autobahn subdirectory.
github.com/fasthttp | golang.org/x/net | |
---|---|---|
RFC 6455 Features | ||
Passes Autobahn Test Suite | Yes | No |
Receive fragmented message | Yes | No, see note 1 |
Send close message | Yes | No |
Send pings and receive pongs | Yes | No |
Get the type of a received data message | Yes | Yes, see note 2 |
Other Features | ||
Compression Extensions | Experimental | No |
Read message using io.Reader | Yes | No, see note 3 |
Write message using io.WriteCloser | Yes | No, see note 3 |
Notes:
- Large messages are fragmented in Chrome's new WebSocket implementation.
- The application can get the type of a received data message by implementing a codec marshal function.
- The go/net
io.Reader
andio.Writer
operate across WebSocket frame boundaries. Read returns when the input buffer is full or a frame boundary is encountered. Each call to Write sends a single frame message. The Gorillaio.Reader
andio.WriteCloser
operate on a single WebSocket message.