/websocket

A WebSocket implementation for Go.
  1. Go 100.0%
Go
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP
Find file
Switch branches/tags
Nothing to show
Latest commit d965e9a Dec 28, 2017 @garyburd garyburd Handle no status in FormatCloseMessage 
Return empty message for CloseNoStatusReceived. This status indicates
that the message is empty, so make it so. Because it's illegal to send
CloseNoStatusReceived, this change should not break a correct
application.
Permalink
Failed to load latest commit information.
examples examples/chat/client.go: avoid allocating []byte{} for PingMessage (#312 Dec 10, 2017
.gitignore Meaningful names for hub May 18, 2016
.travis.yml Add Go 1.9 to Travis config Sep 14, 2017
AUTHORS Relicense to the Gorilla WebSocket Authors. Apr 18, 2014
LICENSE Relicense to the Gorilla WebSocket Authors. Apr 18, 2014
README.md Update README.md Oct 21, 2016
client.go Add SOCKS5 support Dec 1, 2017
client_clone.go Update cloneTLSConfig to use Go 1.8 Config.Clone method Feb 18, 2017
client_clone_legacy.go Update cloneTLSConfig to use Go 1.8 Config.Clone method Feb 18, 2017
client_server_test.go Add SOCKS5 support Dec 1, 2017
client_test.go Replace parseURL() with net/url.Parse() (#290) Oct 13, 2017
compression.go fix flate write pool size to work with best compression Jan 24, 2017
compression_test.go remove test as HuffmanOnly compression level not defined in Go < 1.7 Jan 24, 2017
conn.go Handle no status in FormatCloseMessage Dec 28, 2017
conn_broadcast_test.go Prepared Messages (#211) Feb 14, 2017
conn_read.go Reduce memory allocations in NextReader, NextWriter May 31, 2016
conn_read_legacy.go Reduce memory allocations in NextReader, NextWriter May 31, 2016
conn_test.go Update with gofmt on tip Nov 23, 2017
doc.go Improve control message handling documentation Nov 19, 2017
example_test.go Fix go vet warning Mar 2, 2016
json.go Misc cleanup Jul 18, 2017
json_test.go Provide all close frame data to application Aug 11, 2015
mask.go Update with gofmt on tip Nov 23, 2017
mask_safe.go Add safe maskBytes Jan 1, 2017
mask_test.go Add safe maskBytes Jan 1, 2017
prepared.go Prepared Messages (#211) Feb 14, 2017
prepared_test.go Prepared Messages (#211) Feb 14, 2017
proxy.go Add SOCKS5 support Dec 1, 2017
server.go Improve bad handshake error text Dec 1, 2017
server_test.go Use ASCII case folding in same origin test Nov 28, 2017
util.go Update with gofmt on tip Nov 23, 2017
util_test.go Add parseExtensions test case (#310) Dec 5, 2017
x_net_proxy.go Add SOCKS5 support Dec 1, 2017

README.md

Gorilla WebSocket

Gorilla WebSocket is a Go implementation of the WebSocket protocol.

Build Status GoDoc

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/gorilla/websocket

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/gorilla golang.org/x/net
RFC 6455 Features
Passes Autobahn Test SuiteYesNo
Receive fragmented messageYesNo, see note 1
Send close messageYesNo
Send pings and receive pongsYesNo
Get the type of a received data messageYesYes, see note 2
Other Features
Compression ExtensionsExperimentalNo
Read message using io.ReaderYesNo, see note 3
Write message using io.WriteCloserYesNo, 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.