handle¶

The underlying AnyEvent::Handle object used for the connection. WebSocket handshake MUST be already completed using this handle. You should not use the handle directly after creating AnyEvent::WebSocket::Connection object.

Usually only useful for creating server connections, see below.

masked¶

If set to true, it masks outgoing frames. The default is false.

subprotocol¶

The subprotocol returned by the server. If no subprotocol was requested, it may be "undef".

max_payload_size¶

The maximum payload size for received frames. Currently defaults to whatever Protocol::WebSocket defaults to.

max_fragments¶

The maximum number of fragments for received frames. Currently defaults to whatever Protocol::WebSocket defaults to.

close_code¶

If provided by the other side, the code that was provided when the connection was closed.

close_reason¶

If provided by the other side, the reason for closing the connection.

close_error¶

If the connection is closed due to a network error, this will hold the message.

send¶

 $connection->send($message);

Send a message to the other side. $message may either be a string (in which case a text message will be sent), or an instance of AnyEvent::WebSocket::Message.

on¶

 $connection->on(each_message => $cb);
 $connection->on(each_message => $cb);
 $connection->on(finish => $cb);

Register a callback to a particular event.

For each event $connection is the AnyEvent::WebSocket::Connection and and $message is an AnyEvent::WebSocket::Message (if available).

Returns a coderef that unregisters the callback when invoked.

 my $cancel = $connection->on( each_message => sub { ...  });
 
 # later on...
 $cancel->();

each_message

 $cb->($connection, $message, $unregister)

Called each time a message is received from the WebSocket. $unregister is a coderef that removes this callback from the active listeners when invoked.

next_message

 $cb->($connection, $message)

Called only for the next message received from the WebSocket.

[0.49]

Adding a next_message callback from within a next_message callback will result in a callback called on the next message instead of the current one. There was a bug in previous versions where the callback would be called immediately after current set of callbacks with the same message.

parse_error

 $cb->($connection, $text_error_message)

Called if there is an error parsing a message sent from the remote end. After this callback is called, the connection will be closed. Among other possible errors, this event will trigger if a frame has a payload which is larger that "max_payload_size".

finish

 $cb->($connection, $message)

Called when the connection is terminated. If the connection is terminated due to an error, the message will be provided as the second argument. On a cleanly closed connection this will be `undef`.

close¶

 $connection->close;
 $connection->close($code);
 $connection->close($code, $reason);

Close the connection. You may optionally provide a code and a reason. See section 5.5.1 <https://tools.ietf.org/html/rfc6455#section-5.5.1> and section 7.4.1 <https://tools.ietf.org/html/rfc6455#section-7.4.1> of RFC6455.

The code is a 16-bit unsigned integer value that indicates why you close the connection. By default the code is 1000.

The reason is a character string (not an octet string) that further describes why you close the connection. By default the reason is an empty string.