html5 udp socket

html5-udp-socket

[BORRADOR]

API de socket UDP propuesta por el ex W3C Sysapps WG

Nota: En el momento de esta especificación, la API STREAM aún no estaba finalizada. Esta implementación probablemente requerirá algunas adaptaciones en sus algoritmos.

Referencia: API de socket TCP UDP

como usar

A cosas a tener en cuenta:

1. Esta implementación es todavía sólo un borrador en progreso. Necesita al menos completar las implementaciones de propiedades de Stream readable y writable .
2. Se espera que se utilice como una capa de alto nivel que funcione con proveedores dedicados.

El objetivo es escribir adaptadores de proveedores como:

• Complemento Cordova (Android/iOs/...)
• Reaccionar nativo / NativeScript
• Aplicación de Chrome
• Sistema operativo Firefox
• WinJS
• node.js/Wakanda
• JS común

Cualquiera es bienvenido a contribuir a este proyecto ;-)

Ejemplo de uso

 //
// This example shows a simple implementation of UPnP-SSDP M-SEARCH
// discovery using a multicast UDPSocket
//

var address = '239.255.255.250' ,
    port = '1900' ,
    serviceType = 'upnp:rootdevice' ,
    rn = 'rn' ,
    search = '' ;

//  Request permission to send multicast messages to the address and
//  port reserved for SSDP
navigator . udpPermission . requestPermission ( { remoteAddress : "239.255.255.250" ,
                                           remotePort : 1900 } ) . then (
  ( ) => {
    // Permission was granted

    //  Create a new UDP client socket
    var mySocket = new UDPSocket ( ) ;

    // Build an SSDP M-SEARCH multicast message
    search += 'M-SEARCH * HTTP/1.1' + rn ;
    search += 'ST: ' + serviceType + rn ;
    search += 'MAN: "ssdp:discover"' + rn ;
    search += 'HOST: ' + address + ':' + port + rn ;
    search += 'MX: 10' ;


    // Receive and log SSDP M-SEARCH response messages
    function receiveMSearchResponses ( ) {
      mySocket . readable . getReader ( ) . read ( ) . then ( ( { value , done } ) => {
        if ( done ) return ;

        console . log ( 'Remote address: ' + value . remoteAddress +
                    'Remote port: ' + value . remotePort +
                    'Message: ' + ab2str ( value . data ) ) ;
        // ArrayBuffer to string conversion could also be done by piping
        // through a transform stream. To be updated when the Streams API
        // specification has been stabilized on this point.
      } ) ;
    }

    // Join SSDP multicast group
    mySocket . joinMulticast ( address ) ;

    // Send SSDP M-SEARCH multicast message
    mySocket . writeable . write (
      { data : str2ab ( search ) ,
       remoteAddress : address ,
       remotePort : port
      } ) . then (
        ( ) => {
          // Data sent sucessfully, wait for response
          console . log ( 'M-SEARCH Sent' ) ;
          receiveMSearchResponses ( ) ;
        } ,
        e => console . error ( "Sending error: " , e ) ;
    ) ;

    // Log result of UDP socket setup.
    mySocket . opened . then (
      ( ) => {
        console . log ( "UDP socket created sucessfully" ) ;
      } ,
      e => console . error ( "UDP socket setup failed due to error: " , e ) ;
    ) ;

    // Handle UDP socket closed, either as a result of the application
    // calling mySocket.close() or an error causing the socket to be
    // closed.
    mySocket . closed . then (
      ( ) => {
         console . log ( "Socket has been cleanly closed" ) ;
      } ,
      e => console . error ( "Socket closed due to error: " , e ) ;
    ) ;

  } ,
  e => console . error ( "Sending SSDP multicast messages was denied due to error: " , e ) ;
) ; 

Licencia MIT

Copyright (c) 2016 Alexandre Morgaut

Por el presente se otorga permiso, sin cargo, a cualquier persona que obtenga una copia de este software y los archivos de documentación asociados (el "Software"), para operar con el Software sin restricciones, incluidos, entre otros, los derechos de uso, copia, modificación, fusión. , publicar, distribuir, sublicenciar y/o vender copias del Software, y permitir que las personas a quienes se les proporciona el Software lo hagan, sujeto a las siguientes condiciones:

El aviso de derechos de autor anterior y este aviso de permiso se incluirán en todas las copias o partes sustanciales del Software.

EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGÚN RECLAMO, DAÑO U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN CONTRACTUAL, AGRAVIO O DE OTRA MANERA, QUE SURJA DE, FUERA DE O EN RELACIÓN CON EL SOFTWARE O EL USO U OTRAS NEGOCIOS EN EL SOFTWARE.