/* * Copyright (C)2005-2013 Haxe Foundation * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. */ // This file is generated, do not edit! package js.html; /**

This is an experimental feature
Because this feature is still in development in some browsers, check the compatibility table for the proper prefixes to use in various browsers.

The WebSocket object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.

Documentation for this class was provided by MDN. */ @:native("WebSocket") extern class WebSocket extends EventTarget { /** The connection is closed or couldn't be opened. */ static inline var CLOSED : Int = 3; /** The connection is in the process of closing. */ static inline var CLOSING : Int = 2; /** The connection is not yet open. */ static inline var CONNECTING : Int = 0; /** The connection is open and ready to communicate. */ static inline var OPEN : Int = 1; var URL(default,null) : String; /** A string indicating the type of binary data being transmitted by the connection. This should be either "blob" if DOM Blob objects are being used or "arraybuffer" if ArrayBuffer objects are being used. */ var binaryType : String; /** The number of bytes of data that have been queued using calls to but not yet transmitted to the network. This value does not reset to zero when the connection is closed; if you keep calling , this will continue to climb. Read only. */ var bufferedAmount(default,null) : Int; /** The extensions selected by the server. This is currently only the empty string or a list of extensions as negotiated by the connection. */ var extensions(default,null) : String; /** An event listener to be called when the WebSocket connection's readyState changes to CLOSED. The listener receives a CloseEvent named "close". */ var onclose : EventListener; /** An event listener to be called when an error occurs. This is a simple event named "error". */ var onerror : EventListener; /** An event listener to be called when a message is received from the server. The listener receives a MessageEvent named "message". */ var onmessage : EventListener; /** An event listener to be called when the WebSocket connection's readyState changes to OPEN; this indicates that the connection is ready to send and receive data. The event is a simple one with the name "open". */ var onopen : EventListener; /** A string indicating the name of the sub-protocol the server selected; this will be one of the strings specified in the protocols parameter when creating the WebSocket object. */ var protocol(default,null) : String; /** The current state of the connection; this is one of the Ready state constants. Read only. */ var readyState(default,null) : Int; /** The URL as resolved by the constructor. This is always an absolute URL. Read only. */ var url(default,null) : String; function new( ?arg0 : Dynamic ) : Void; function close( ?code : Int, ?reason : String ) : Void; /**

Transmits data to the server over the WebSocket connection.

Parameters

data: A text string to send to the server.

Exceptions thrown

INVALID_STATE_ERR: The connection is not currently OPEN.
SYNTAX_ERR: The data is a string that has unpaired surrogates.

Remarks

Gecko 6.0 note

(Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3)

Gecko's implementation of the send() method differs somewhat from the specification in Gecko 6.0; Gecko returns a boolean indicating whether or not the connection is still open (and, by extension, that the data was successfully queued or transmitted); this is corrected in Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5) . In addition, at this time, Gecko does not support ArrayBuffer or Blob data types.

Throws DOMException. */ @:overload( function( data : ArrayBuffer ) :Bool {} ) @:overload( function( data : ArrayBufferView ) :Bool {} ) @:overload( function( data : Blob ) :Bool {} ) function send( data : String ) : Bool; }