Introduction

Installation

Questions fréquemment posées

Syntaxe, mots-clés et fonctions intégrées

Distribution standard

Implémentation de import

Interface avec le navigateur

Modules intégrés propres à Brython

Travailler avec Brython

Recettes

 

module browser.websocket

Les Web sockets, définies dans HTML5, sont un moyen de gérer une communication bidirectionnelle entre le client et le serveur

Le module définit un booléen

supported
indique si le protocole WebSocket est supporté par le navigateur

et une fonction

WebSocket(hote)
hote est l'adresse d'un serveur qui supporte le protocole WebSocket. Renvoie un objet WebSocket. Si le navigateur ne gère pas ce protocole, une exception NotImplementedError est déclenchée.

Les objets WebSocket possèdent les méthodes suivantes :

bind(evt,fonction)
associe la fonction à l'événement evt. Les événements gérés et les arguments de la fonction sont :

Evénement Fonction
open fonction sans argument, appelée une fois que la connexion avec le serveur est établie
error fonction sans argument, appelée si une erreur se produit pendant la communication
message fonction qui prend un argument, une instance de DOMEvent. Cette instance possède un attribut data qui contient le message envoyé par le serveur
close fonction sans argument, appelée quand la connexion est close

send(data)
envoie la chaine data au serveur

close()
ferme la connection

Exemple :

from browser import alert, document as doc
from browser import websocket

def on_open(evt):
    doc['sendbtn'].disabled = False
    doc['closebtn'].disabled = False
    doc['openbtn'].disabled = True

def on_message(evt):
    # message reçu du serveur
    alert("Message reçu : %s" %evt.data)

def on_close(evt):
    # la websocket est fermée
    alert("La connexion est fermée")
    doc['openbtn'].disabled = False
    doc['closebtn'].disabled = True
    doc['sendbtn'].disabled = True

ws = None
def _open(ev):
    if not websocket.supported:
        alert("WebSocket n'est pas pris en charge par votre navigateur")
        return
    global ws
    # open a web socket
    ws = websocket.WebSocket("wss://echo.websocket.org")
    # attache des fonctions aux événements web sockets
    ws.bind('open',on_open)
    ws.bind('message',on_message)
    ws.bind('close',on_close)

def send(ev):
    data = doc["data"].value
    if data:
        ws.send(data)

def close_connection(ev):
    ws.close()
    doc['openbtn'].disabled = False

doc['openbtn'].bind('click', _open)
doc['sendbtn'].bind('click', send)
doc['closebtn'].bind('click', close_connection)