method WebSocket.recv
Waits for the next message or control frame. After a Close message the next call fails with Unavailable.
Example:
use std.http { Server, ServerConfig, ServerHandle, Router, Request, Reply, Client, Header, HttpConfig, Response, WebSocket, WsConfig, WsKind, WsMessage, SseWriter, SseStream, SseConfig, SseEvent, BodyWriter, Http2, Http2Handle, ResponseStream, chunks }
fn run() -> () | NetError | DecodeError | Panicked net, io, time {
let srv = Server.bind(ServerConfig{ port: 0, followNode: false })?
defer srv.close()
let stop = srv.handle()
let base = "http://127.0.0.1:{srv.port()}"
let router = Router.new().get("/ws", (req: Request) => Reply.websocket((ws: WebSocket) => {
var open = true
while open {
let m = ws.recv()?
if m.kind == WsKind.Text {
ws.sendText("echo:{m.text}")?
} else if m.kind == WsKind.Binary {
ws.sendBinary(m.payload)?
} else if m.kind == WsKind.Close {
open = false
}
}
}))
scope {
spawn stop.serve(router)
let ws = WebSocket.connect("ws://127.0.0.1:{srv.port()}/ws")?
defer ws.close()?
match ws.recv(100ms) {
WsMessage m => print("got {m.kind == WsKind.Text}")
Timeout _ => print("nothing yet")
NetError _ => print("error")
}
stop.shutdown()
()
}?
}
fn main() io, net, time {
match run() {
NetError _ => print("net error")
DecodeError _ => print("decode error")
Panicked _ => print("panicked")
_ => {}
}
}Output
nothing yet
pub(api) fn recv(timeout: Duration? = none) -> WsMessage | NetError netSince. 1.0.0-beta
Parameters
| Name | Type |
|---|---|
timeout | Duration? = none |
Returns
Errors
NetError- `Timeout` when nothing arrives in time, `Unavailable` (after a `Close` message and when the connection breaks), `ProtocolError` (a message above `maxMessage`, a malformed frame), `Cancelled`.
Effects
net
Defined in: std/http/http.oxl:2496