gun_ws(3)

Name

gun_ws - Websocket frame

Description

{gun_ws, ConnPid, StreamRef, Frame}

ConnPid   :: pid()
StreamRef :: gun:stream_ref()
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

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)