gun_ws(3)

Name

gun_ws - Websocket frame

Description

{gun_ws, ConnPid, StreamRef, Frame}

ConnPid   :: pid()
StreamRef :: reference()
Frame     :: close | ping | pong
           | {text | binary | close, binary()}
           | {close, non_neg_integer(), binary()}
           | {ping | pong, binary()}

Websocket frame.

This message informs the relevant process that the server sent the enclosed frame.

This message can only be sent on streams that were upgraded to the Websocket protocol.

Elements

ConnPid

The pid of the Gun connection process.

StreamRef

Identifier of the stream that was upgraded to Websocket.

Frame

The Websocket frame in question.

Changelog

  • 2.0: Depending on the option silence_pings, ping and pong frames may be sent as well.
  • 1.0: Message introduced.

Examples

Receive a gun_ws message in a gen_server
handle_info({gun_ws, ConnPid, _StreamRef, _Frame},
            State=#state{conn_pid=ConnPid}) ->
    %% Do something.
    {noreply, State}.

See also

gun(3), gun:ws_upgrade(3), gun:ws_send(3), gun_upgrade(3)

Gun 2.0 Function Reference

Navigation

Version select

Like my work? Donate!

Donate to Loïc Hoguin because his work on Cowboy, Ranch, Gun and Erlang.mk is fantastic:

Recurring payment options are also available via BountySource. These funds are used to cover the recurring expenses like dedicated servers or domain names.