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]) (def socket (ws/connect "ws://example.org:1234/socket" :on-receive #(prn 'received %))) (ws/send-msg socket "hello") (ws/close socket)
(gniazdo.core/connect uri & options)
gniazdo.core/connect opens a WebSocket connection using a
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
Throwabledescribing the error.
:on-close– a binary function called when the connection is closed. Arguments are an
intstatus code and a
Stringdescription 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
WebSocketClientinstance 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 [conn message])
gniazdo.core/send-msg sends a given message using a connection established
gniazdo.core/connect. The message should be a
(gniazdo.core/close [conn] [conn status-code reason])
gniazdo.core/close closes a connection established with
gniazdo.core/connect. Optionally includes a status int and reason.
(gniazdo.core/client  [uri])
gniazdo.core/client creates an instance of
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
gniazdo.core/connect, and it must be closed (
after the websocket has been closed to prevent a resource leak.
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 http://www.apache.org/licenses/LICENSE-2.0 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.