Package org.htmlunit.javascript.host

Class WebSocket

java.lang.Object
org.htmlunit.corejs.javascript.ScriptableObject
org.htmlunit.javascript.HtmlUnitScriptable
org.htmlunit.javascript.host.event.EventTarget
org.htmlunit.javascript.host.WebSocket
All Implemented Interfaces:
Serializable, AutoCloseable, Cloneable, org.htmlunit.corejs.javascript.ConstProperties, org.htmlunit.corejs.javascript.debug.DebuggableObject, org.htmlunit.corejs.javascript.Scriptable, org.htmlunit.corejs.javascript.SymbolScriptable
public class WebSocket extends EventTarget implements AutoCloseable
A JavaScript object for WebSocket.
See Also:

  • Nested Class Summary

    Nested classes/interfaces inherited from class org.htmlunit.corejs.javascript.ScriptableObject

    org.htmlunit.corejs.javascript.ScriptableObject.KeyComparator

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private String
    binaryType_
     
    static final int
    CLOSED
    The connection has been closed or could not be opened.
    private org.htmlunit.corejs.javascript.Function
    closeHandler_
     
    static final int
    CLOSING
    The connection is going through the closing handshake.
    static final int
    CONNECTING
    The connection has not yet been established.
    private HtmlPage
    containingPage_
     
    private org.htmlunit.corejs.javascript.Function
    errorHandler_
     
    private static final org.apache.commons.logging.Log
    LOG
     
    private org.htmlunit.corejs.javascript.Function
    messageHandler_
     
    static final int
    OPEN
    The WebSocket connection is established and communication is possible.
    private org.htmlunit.corejs.javascript.Function
    openHandler_
     
    private boolean
    originSet_
     
    private int
    readyState_
     
    private URI
    url_
     
    private WebSocketAdapter
    webSocketImpl_
     

    Fields inherited from class org.htmlunit.corejs.javascript.ScriptableObject

    CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST

    Fields inherited from interface org.htmlunit.corejs.javascript.Scriptable

    NOT_FOUND

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
     
    WebSocket()
    Creates a new instance.
    private
    WebSocket(String url, Window window)
    Creates a new instance.

  • Method Summary

    Modifier and Type
    Method
    Description
    (package private) void
    callFunction(org.htmlunit.corejs.javascript.Function function, Object[] args)
     
    void
    close()
    void
    close(Object code, Object reason)
    Closes the WebSocket connection or connection attempt, if any.
    (package private) void
    fire(Event evt)
     
    String
    getBinaryType()
     
    long
    getBufferedAmount()
     
    org.htmlunit.corejs.javascript.Function
    getOnclose()
    Returns the event handler that fires on close.
    org.htmlunit.corejs.javascript.Function
    getOnerror()
    Returns the event handler that fires on error.
    org.htmlunit.corejs.javascript.Function
    getOnmessage()
    Returns the event handler that fires on message.
    org.htmlunit.corejs.javascript.Function
    getOnopen()
    Returns the event handler that fires on open.
    String
    getProtocol()
     
    int
    getReadyState()
    Returns The current state of the connection.
    String
    getUrl()
     
    static org.htmlunit.corejs.javascript.Scriptable
    jsConstructor(org.htmlunit.corejs.javascript.Context cx, org.htmlunit.corejs.javascript.Scriptable scope, Object[] args, org.htmlunit.corejs.javascript.Function ctorObj, boolean inNewExpr)
    JavaScript constructor.
    void
    send(Object content)
    Transmits data to the server over the WebSocket connection.
    void
    setBinaryType(String type)
    Sets the used binary type.
    void
    setOnclose(org.htmlunit.corejs.javascript.Function closeHandler)
    Sets the event handler that fires on close.
    void
    setOnerror(org.htmlunit.corejs.javascript.Function errorHandler)
    Sets the event handler that fires on error.
    void
    setOnmessage(org.htmlunit.corejs.javascript.Function messageHandler)
    Sets the event handler that fires on message.
    void
    setOnopen(org.htmlunit.corejs.javascript.Function openHandler)
    Sets the event handler that fires on open.
    (package private) void
    setReadyState(int readyState)
     

    Methods inherited from class org.htmlunit.javascript.host.event.EventTarget

    addEventListener, clearEventListenersContainer, dispatchEvent, executeEventLocally, fireEvent, getEventHandler, getEventListenersContainer, hasEventHandlers, isEventHandlerOnWindow, jsConstructor, removeEventListener, setEventHandler

    Methods inherited from class org.htmlunit.javascript.HtmlUnitScriptable

    clone, equivalentValues, get, getBrowserVersion, getClassName, getDefaultValue, getDomNodeOrDie, getDomNodeOrNull, getPrototype, getScriptableFor, getStartingScope, getWindow, getWindow, getWithPreemption, has, hasInstance, initParentScope, makeScriptableFor, put, setClassName, setDomNode, setDomNode, setParentScope, setupPromise, setupRejectedPromise

    Methods inherited from class org.htmlunit.corejs.javascript.ScriptableObject

    applyDescriptorToAttributeBitset, associateValue, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkPropertyChange, checkPropertyDefinition, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureSymbolScriptable, get, get, get, getAllIds, getArrayPrototype, getAssociatedValue, getAttributes, getAttributes, getAttributes, getAttributes, getAttributes, getClassPrototype, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGeneratorFunctionPrototype, getGetterOrSetter, getGetterOrSetter, getIds, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, has, has, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isConst, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGetterOrSetter, isSealed, isTrue, preventExtensions, put, put, putConst, putConstProperty, putProperty, putProperty, putProperty, querySlot, redefineProperty, sameValue, sealObject, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, setCommonDescriptorProperties, setExternalArrayData, setGetterOrSetter, setPrototype, size

    Methods inherited from class java.lang.Object

    equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • LOG

      private static final org.apache.commons.logging.Log LOG

    • CONNECTING

      public static final int CONNECTING
      The connection has not yet been established.
      See Also:

    • OPEN

      public static final int OPEN
      The WebSocket connection is established and communication is possible.
      See Also:

    • CLOSING

      public static final int CLOSING
      The connection is going through the closing handshake.
      See Also:

    • CLOSED

      public static final int CLOSED
      The connection has been closed or could not be opened.
      See Also:

    • closeHandler_

      private org.htmlunit.corejs.javascript.Function closeHandler_

    • errorHandler_

      private org.htmlunit.corejs.javascript.Function errorHandler_

    • messageHandler_

      private org.htmlunit.corejs.javascript.Function messageHandler_

    • openHandler_

      private org.htmlunit.corejs.javascript.Function openHandler_

    • url_

      private URI url_

    • readyState_

      private int readyState_

    • binaryType_

      private String binaryType_

    • containingPage_

      private HtmlPage containingPage_

    • webSocketImpl_

      private WebSocketAdapter webSocketImpl_

    • originSet_

      private boolean originSet_

  • Constructor Details

    • WebSocket

      public WebSocket()
      Creates a new instance.

    • WebSocket

      private WebSocket(String url, Window window)
      Creates a new instance.
      Parameters:
      url - the URL to which to connect
      window - the top level window

  • Method Details

    • jsConstructor

      public static org.htmlunit.corejs.javascript.Scriptable jsConstructor(org.htmlunit.corejs.javascript.Context cx, org.htmlunit.corejs.javascript.Scriptable scope, Object[] args, org.htmlunit.corejs.javascript.Function ctorObj, boolean inNewExpr)
      JavaScript constructor.
      Parameters:
      cx - the current context
      scope - the scope
      args - the arguments to the WebSocket constructor
      ctorObj - the function object
      inNewExpr - Is new or not
      Returns:
      the java object to allow JavaScript to access

    • getOnclose

      public org.htmlunit.corejs.javascript.Function getOnclose()
      Returns the event handler that fires on close.
      Returns:
      the event handler that fires on close

    • setOnclose

      public void setOnclose(org.htmlunit.corejs.javascript.Function closeHandler)
      Sets the event handler that fires on close.
      Parameters:
      closeHandler - the event handler that fires on close

    • getOnerror

      public org.htmlunit.corejs.javascript.Function getOnerror()
      Returns the event handler that fires on error.
      Returns:
      the event handler that fires on error

    • setOnerror

      public void setOnerror(org.htmlunit.corejs.javascript.Function errorHandler)
      Sets the event handler that fires on error.
      Parameters:
      errorHandler - the event handler that fires on error

    • getOnmessage

      public org.htmlunit.corejs.javascript.Function getOnmessage()
      Returns the event handler that fires on message.
      Returns:
      the event handler that fires on message

    • setOnmessage

      public void setOnmessage(org.htmlunit.corejs.javascript.Function messageHandler)
      Sets the event handler that fires on message.
      Parameters:
      messageHandler - the event handler that fires on message

    • getOnopen

      public org.htmlunit.corejs.javascript.Function getOnopen()
      Returns the event handler that fires on open.
      Returns:
      the event handler that fires on open

    • setOnopen

      public void setOnopen(org.htmlunit.corejs.javascript.Function openHandler)
      Sets the event handler that fires on open.
      Parameters:
      openHandler - the event handler that fires on open

    • getReadyState

      public int getReadyState()
      Returns The current state of the connection. The possible values are: CONNECTING, OPEN, CLOSING or CLOSED.
      Returns:
      the current state of the connection

    • setReadyState

      void setReadyState(int readyState)

    • getUrl

      public String getUrl()
      Returns:
      the url

    • getProtocol

      public String getProtocol()
      Returns:
      the sub protocol used

    • getBufferedAmount

      public long getBufferedAmount()
      Returns:
      the sub protocol used

    • getBinaryType

      public String getBinaryType()
      Returns:
      the used binary type

    • setBinaryType

      public void setBinaryType(String type)
      Sets the used binary type.
      Parameters:
      type - the type

    • close

      public void close() throws IOException
      Specified by:
      close in interface AutoCloseable
      Throws:
      IOException

    • close

      public void close(Object code, Object reason)
      Closes the WebSocket connection or connection attempt, if any. If the connection is already CLOSED, this method does nothing.
      Parameters:
      code - A numeric value indicating the status code explaining why the connection is being closed
      reason - A human-readable string explaining why the connection is closing

    • send

      public void send(Object content)
      Transmits data to the server over the WebSocket connection.
      Parameters:
      content - the body of the message being sent with the request

    • fire

      void fire(Event evt)

    • callFunction

      void callFunction(org.htmlunit.corejs.javascript.Function function, Object[] args)