Class: WebSocketTunnel

Guacamole.WebSocketTunnel(tunnelURL)

new WebSocketTunnel(tunnelURL)

Guacamole Tunnel implemented over WebSocket via XMLHttpRequest.
Parameters:
Name Type Description
tunnelURL String The URL of the WebSocket tunneling service.
Source:

Extends

Members

receiveTimeout :Number

The maximum amount of time to wait for data to be received, in milliseconds. If data is not received within this amount of time, the tunnel is closed with an error. The default value is 15000.
Type:
  • Number
Inherited From:
Source:

state :Number

The current state of this tunnel.
Type:
  • Number
Inherited From:
Source:

unstableThreshold :Number

The amount of time to wait for data to be received before considering the connection to be unstable, in milliseconds. If data is not received within this amount of time, the tunnel status is updated to warn that the connection appears unresponsive and may close. The default value is 1500.
Type:
  • Number
Inherited From:
Source:

uuid :String

The UUID uniquely identifying this tunnel. If not yet known, this will be null.
Type:
  • String
Inherited From:
Source:

Methods

connect(data)

Connect to the tunnel with the given optional data. This data is typically used for authentication. The format of data accepted is up to the tunnel implementation.
Parameters:
Name Type Description
data String The data to send to the tunnel when connecting.
Overrides:
Source:

disconnect()

Disconnect from the tunnel.
Overrides:
Source:

isConnected() → {Boolean}

Returns whether this tunnel is currently connected.
Inherited From:
Source:
Returns:
true if this tunnel is currently connected, false otherwise.
Type
Boolean

sendMessage(…elements)

Send the given message through the tunnel to the service on the other side. All messages are guaranteed to be received in the order sent.
Parameters:
Name Type Attributes Description
elements * <repeatable>
The elements of the message to send to the service on the other side of the tunnel.
Overrides:
Source:

Events

onerror

Fired whenever an error is encountered by the tunnel.
Parameters:
Name Type Description
status Guacamole.Status A status object which describes the error.
Inherited From:
Source:

oninstruction

Fired once for every complete Guacamole instruction received, in order.
Parameters:
Name Type Description
opcode String The Guacamole instruction opcode.
parameters Array The parameters provided for the instruction, if any.
Inherited From:
Source:

onstatechange

Fired whenever the state of the tunnel changes.
Parameters:
Name Type Description
state Number The new state of the client.
Inherited From:
Source: