Awesome Open Source
Awesome Open Source

Fasthttp Gorilla WebSocket

Build Status Go Report Card GoDev GitHub release

Gorilla WebSocket is a Go implementation of the WebSocket protocol.

This fork adds fasthttp support to the latest version of gorilla/websocket.

Documentation

Status

The Gorilla WebSocket package provides a complete and tested implementation of the WebSocket protocol. The package API is stable.

Installation

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.

Dep

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/[email protected]

IMPORTANT: dep is only supported until version v1.4.0. In future versions will use Go modules.

Protocol Compliance

The Gorilla WebSocket package passes the server tests in the Autobahn Test Suite using the application in the examples/autobahn subdirectory.

Gorilla WebSocket compared with other packages

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:

  1. Large messages are fragmented in Chrome's new WebSocket implementation.
  2. The application can get the type of a received data message by implementing a codec marshal function.
  3. The go/net io.Reader and io.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 Gorilla io.Reader and io.WriteCloser operate on a single WebSocket message.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
go (15,172
golang (3,889
websocket (479
gorilla (16