Skip to content

$websocket.send

Description

Envoie un message à une ou plusieurs sessions websocket.

Syntaxe

$websocket.send( message [ , options ] )

Paramètres

message string
Message à envoyer
options map

Option d'envoi de message. Les options reconnues sont:

dest string

Chaîne de caractères indiquant qui sont les destinataires du message à envoyer. Les valeurs possibles sont:

  • "current": envoie le message au client qui est à l'origine du thread actuel; c'est le comportement par défaut
  • "all": envoie le message à tous les clients connectés sur le canal courant
  • "others": envoie le message à tous les clients connectés sur le canal courant, à l'exception du client qui est à l'origine du thread actuel

Retour

Retourne true si le message a pu être envoyé, sinon false.

Exemple

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
@accept(servlet="websocket")

switch ($$.event) {
    case "open":
        $websocket.send("hello " & $request.getPrincipal());
        break;
    case "message":
        $websocket.send("😀 " & $$.message, { dest: "current" });
        $websocket.send("🌍 " & $$.message, { dest: "others" });
        break;
    case "close":
        break;
    case "error":
        break;
}