| /* |
| * Copyright (C) 2009 Google Inc. All rights reserved. |
| * Copyright (C) 2010, 2011 Apple Inc. All Rights Reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions are |
| * met: |
| * |
| * * Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * * Redistributions in binary form must reproduce the above |
| * copyright notice, this list of conditions and the following disclaimer |
| * in the documentation and/or other materials provided with the |
| * distribution. |
| * * Neither the name of Google Inc. nor the names of its |
| * contributors may be used to endorse or promote products derived from |
| * this software without specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| // https://html.spec.whatwg.org/multipage/comms.html#the-websocket-interface |
| |
| enum BinaryType { "blob", "arraybuffer" }; |
| |
| [ |
| ActiveDOMObject, |
| // FIXME: Spec has DOMString[]. https://www.w3.org/Bugs/Public/show_bug.cgi?id=28102 |
| Constructor(DOMString url, optional (DOMString or sequence<DOMString>) protocols), |
| ConstructorCallWith=ExecutionContext, |
| Exposed=(Window,Worker), |
| TypeChecking=Interface, |
| RaisesException=Constructor, |
| GarbageCollected, |
| ImplementedAs=DOMWebSocket, |
| ] interface WebSocket : EventTarget { |
| readonly attribute DOMString url; |
| |
| // ready state |
| const unsigned short CONNECTING = 0; |
| const unsigned short OPEN = 1; |
| const unsigned short CLOSING = 2; |
| const unsigned short CLOSED = 3; |
| readonly attribute unsigned short readyState; |
| readonly attribute unsigned long bufferedAmount; |
| |
| // networking |
| attribute EventHandler onopen; |
| attribute EventHandler onerror; |
| attribute EventHandler onclose; |
| readonly attribute DOMString extensions; |
| readonly attribute DOMString protocol; |
| [RaisesException] void close([Clamp] optional unsigned short code, optional USVString reason); |
| |
| // messaging |
| attribute EventHandler onmessage; |
| attribute BinaryType binaryType; |
| [RaisesException] void send(USVString data); |
| [RaisesException] void send(Blob data); |
| [RaisesException] void send(ArrayBuffer data); |
| [RaisesException] void send(ArrayBufferView data); |
| }; |