https://github.com/posener/wstest

go websocket client for unit testing of a websocket handler
https://github.com/posener/wstest

go golang gorilla gorilla-websocket test websocket

Last synced: 24 days ago
JSON representation

go websocket client for unit testing of a websocket handler

• Host: GitHub
• URL: https://github.com/posener/wstest
• Owner: posener
• License: apache-2.0
• Created: 2017-03-31T21:06:18.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2020-12-30T21:32:28.000Z (over 3 years ago)
• Last Synced: 2024-04-16T00:14:47.748Z (about 1 month ago)
• Topics: go, golang, gorilla, gorilla-websocket, test, websocket
• Language: Go
• Homepage:
• Size: 52.7 KB
• Stars: 102
• Watchers: 4
• Forks: 18
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Lists

• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go-extra - wstest - 03-31T21:06:18Z|2020-12-30T21:32:28Z| (Testing / Testing Frameworks)
• awesome-go-cn - wstest
• awesome-go-zh - wstest
• awesome-go-cn - wstest
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go-projects - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - testing a websocket http.Handler. | - | - | - | (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go-with-framework - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go-stars - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• go-awesome-cn-star - wstest
• zero-alloc-awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go-cn - wstest
• awesome-go-cn - wstest
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go. - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / Advanced Console UIs)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (<span id="测试-testing">测试 Testing</span> / <span id="高级控制台用户界面-advanced-console-uis">高级控制台用户界面 Advanced Console UIs</span>)
• awesome-go-cn - wstest - Websocket 客户端，用于对于 websocket HTTP.Handler 进行单元测试 (测试 / 高级控制台界面)
• awesome-go-with-stars - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• repo-1316-awesome-go-cn - wstest
• repo-1211-awesome-go-cn - wstest
• awesome-Char - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-reader - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• Go-awesome - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go-cn - wstest - testing a websocket http.Handler.) (测试 / Advanced Console UIs)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / Advanced Console UIs)
• awesome-go - wstest - A websocket client for unit-testing a websocket http.Handler. (Testing / Advanced Console UIs)
• awesome-go-handwritten - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - Websocket 客戶端，用於對於 websocket HTTP.Handler 進行單元測試 (測試 / 高級控制台界面)
• awesome-go - wstest - go websocket client for unit testing of a websocket handler - ★ 48 (Testing)
• awesome-go2 - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / Advanced Console UIs)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. - :arrow_down:0 - :star:37 (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go-zh - wstest
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)
• awesome-go - wstest - Websocket client for unit-testing a websocket http.Handler. (Testing / HTTP Clients)

README

        
# wstest

[![Build Status](https://travis-ci.org/posener/wstest.svg?branch=master)](https://travis-ci.org/posener/wstest)

[![codecov](https://codecov.io/gh/posener/wstest/branch/master/graph/badge.svg)](https://codecov.io/gh/posener/wstest)

[![GoDoc](https://godoc.org/github.com/posener/wstest?status.svg)](http://godoc.org/github.com/posener/wstest)

[![Go Report Card](https://goreportcard.com/badge/github.com/posener/wstest)](https://goreportcard.com/report/github.com/posener/wstest)

A websocket client for unit-testing a websocket server

The [gorilla organization](http://www.gorillatoolkit.org/) provides full featured

[websocket implementation](https://github.com/gorilla/websocket) that the standard library lacks.

The standard library provides a `httptest.ResponseRecorder` struct that test

an `http.Handler` without `ListenAndServe`, but is helpless when the connection is being hijacked

by an http upgrader. As for testing websockets, it has the `httptest.NewServer` that actually

listens on a socket on an arbitrary port.

This package provides a NewDialer function to test just the `http.Handler` that upgrades

the connection to a websocket session. It runs the handler function in a goroutine

without listening on any port. The returned `websocket.Dialer` then can be used to dial and communicate

with the given handler.

## Get

`go get -u github.com/posener/wstest`

## Examples

See the [example test](./example_test.go).

An example how to modify a test function from using

`httptest.Server` to use `wstest.NewDialer` function.

```diff

func TestHandler(t *testing.T) {

	var err error

	h := &myHandler{}

-	s := httptest.NewServer(h)

-	defer s.Close()

-	d := websocket.Dialer{}

+	d := wstest.NewDialer(h)

-	c, resp, err := d.Dial("ws://" + s.Listener.Addr().String() + "/ws", nil)

+	c, resp, err := d.Dial("ws://" + "whatever" + "/ws", nil)

	if err != nil {

		t.Fatal(err)

	}

	

	if got, want := resp.StatusCode, http.StatusSwitchingProtocols; got != want {

		t.Errorf("resp.StatusCode = %q, want %q", got, want)

	}

	

	err = c.WriteJSON("test")

	if err != nil {

		t.Fatal(err)

	}

}

```