Go
Clone or download
Permalink
Failed to load latest commit information.
examples Minor fixes in comments Apr 16, 2018
.gitignore add newline and remove extra space Mar 4, 2018
.travis.yml Travis config: add Go 1.10.x, revert 1.4.x to 1.4 Feb 19, 2018
AUTHORS Update LICENSE file to reflect Google employee contributions. Jun 5, 2018
LICENSE Relicense to the Gorilla WebSocket Authors. Apr 18, 2014
README.md add newline and remove extra space Mar 4, 2018
client.go Modify headers to match case used in RFC examples Apr 20, 2018
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 Improve names in handshake deadline test May 28, 2018
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 Use net.Buffers to write multiple slices to connection Mar 6, 2018
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
conn_write.go Use net.Buffers to write multiple slices to connection Mar 6, 2018
conn_write_legacy.go Use net.Buffers to write multiple slices to connection Mar 6, 2018
doc.go Improve check origin documentation Jan 25, 2018
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 Minor fixes in comments Apr 16, 2018
server.go Modify headers to match case used in RFC examples Apr 20, 2018
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.