OxL Справочник OxL
РусскийEnglish

method WebSocket.recv

Waits for the next message or control frame. After a Close message the next call fails with Unavailable.

Example:

oxl✓ проверяется в CI
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")
    _ => {}
  }
}
Вывод
nothing yet
pub(api) fn recv(timeout: Duration? = none) -> WsMessage | NetError  net

С версии. 1.0.0-beta

Параметры

ИмяТип
timeoutDuration? = none

Возвращает

WsMessage

Ошибки

  • 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`.

Эффекты

net

Определено в: std/http/http.oxl:2496

См. также