Gniazdo is a WebSocket client for Clojure. Its main purpose is testing WebSockets services without a browser. It uses Jetty's implementation of the WebSocket protocol. It supports both
Add the following artifact to
:dependencies in your project.clj:
Here's a minimal usage example:
(require '[gniazdo.core :as ws])
:on-receive #(prn 'received %)))
(ws/send-msg socket "hello")
gniazdo.core/connect opens a WebSocket connection using a given
uri. The following
options/callbacks are available:
:on-connect – a unary function called after the connection has been established. The handler is a
:on-receive – a unary function called when a message is received. The argument is a received
:on-binary – a ternary function called when a message is received. Arguments are the raw payload byte array, and two integers: the offset in the array where the data starts and the length of the payload.
:on-error – a unary function called on in case of errors. The argument is a
Throwable describing the error.
:on-close – a binary function called when the connection is closed. Arguments are an
int status code and a
String description of reason.
:headers – a map of string keys and either string or string seq values to be used as headers for the initial websocket connection request.
:client – an optional
WebSocketClient instance to be used for connection establishment; by default, a new one is created internally on each call.
:subprotocols – an optional sequence of
Strings specifying the subprotocols to announce.
:extensions – an optional sequence of
Strings specifying protocol extensions.
gniazdo.core/connect returns an opaque representation of the connection.
See also WebSocketListener.
gniazdo.core/send-msg sends a given message using a connection established with
gniazdo.core/connect. The message should be a
gniazdo.core/close closes a connection established with
gniazdo.core/client creates an instance of
WebSocketClient, optionally based on the given URI. If secure WebSocket connections are desired, an SSL-capable instance will be created.
Note that the resulting client has to be started (
(.start client)) before it can be used with
In order to use an HTTP proxy configure an
HttpClient and create an instance of
Copyright 2013 stylefruits GmbH
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.