MDN may have intermittent access issues April 18 13:00 - April 19 01:00 UTC. See whistlepig.mozilla.org for all notifications.

mozilla
Os seus resultados da pesquisa

    TCPSocket

    Nossos voluntários ainda não traduziram este artigo para o Português (do Brasil). Junte-se a nós e ajude a fazer o trabalho!

    Non-standard
    This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.

    This API is available on Firefox OS for privileged or certified applications only.

    Summary

    The TCPSocket interface provides access to a raw TCP socket.

    The main entry point for this API is the navigator.mozTCPSocket property which is a TCPSocket object.

    Note: Only certified apps can accept incoming connections on a port below 1024.

    API overview

    interface TCPSocket{
      readonly attribute DOMString host;
      readonly attribute unsigned short port;
      readonly attribute boolean ssl;
      readonly attribute unsigned long bufferedAmount;
      readonly attribute DOMString binaryType;
      readonly attribute DOMString readyState;
    
      TCPSocket open(DOMString host, unsigned short port, [object options]);
      TCPServerSocket listen(unsigned short port, [object options, [unsigned short backlog]]);
      void upgradeToSecure();
      void suspend();
      void resume();
      void close();
      boolean send(in jsval data);
    
      attribute onopen;
      attribute ondrain;
      attribute ondata;
      attribute onerror;
      attribute onclose;
    };

    Properties

    TCPSocket.host Read only
    A string representing the host name of the server the socket is connected to.
    TCPSocket.port Read only
    A number representing the port the socket is connected to.
    TCPSocket.ssl Read only
    A boolean indicating whether the socket is encrypted with SSL (true) or not (false).
    TCPSocket.bufferedAmount Read only
    The number of bytes of not-yet-sent data in the socket buffered.
    TCPSocket.binaryType Read only
    The type of data used. Possible value is arraybuffer or string.
    TCPSocket.readyState Read only
    The socket state. Possible value is connecting, open, closing, or closed.

    Events handler

    TCPSocket.onopen
    A handler for the open event. After this event, the socket is ready to send and receive data.
    TCPSocket.ondrain
    A handler for the drain event. This event is triggered each time the buffer of data is flushed.
    TCPSocket.onerror
    A handler for the error event.
    TCPSocket.ondata
    A handler for the data event. This event is triggered each time data has been received.
    TCPSocket.onclose
    A handler for the close event.

    Methods

    TCPSocket.close()
    Closes the connection.
    TCPSocket.open(host, port [, options])
    Returns a new TCPSocket object connected to the given host at the given port.
    TCPSocket.listen(port [, options [, backlog]]) Requires FirefoxOS 1.2
    Returns a new TCPServerSocket object listening at the given port.
    TCPSocket.resume()
    Resumes the data events.
    TCPSocket.send(data)
    Buffers data to be sent across the network.
    TCPSocket.suspend()
    Pauses the data events.
    TCPSocket.upgradeToSecure() Requires FirefoxOS 1.2
    Enables secure on channel.

    Specification

    Not part of any specification yet; however, this API is discussed at W3C as part of the System Applications Working Group under the TCP and UDP Socket API (formerly known as the Raw Sockets API) proposal.

    See also

    Etiquetas do documento e colaboradores

    Última atualização por: teoli,