6 releases (3 stable)
1.21.0 | Mar 7, 2024 |
---|---|
1.0.1 | Jul 3, 2023 |
1.0.0 | Apr 9, 2023 |
0.2.0 | Feb 12, 2023 |
0.1.0 | Oct 17, 2022 |
#109 in WebSocket
113 downloads per month
21KB
218 lines
yew-websocket
Rust yew websocket service written with love :)
Supports yew version 0.20.0
This crate is based on the original yew websocket service that used to be part of the core library. https://github.com/yewstack/yew/blob/0.18.0/packages/yew/src/services/websocket.rs
For some reason, the core team decided to kill it.
I tried using the suggested libraries (wasm-sockets or gloo-net), but those are not properly integrated with yew.
Sample
use anyhow::Error;
use serde_derive::{Deserialize, Serialize};
use yew_websocket::macros::Json;
use yew::{html, Component, Context, Html};
use yew_websocket::websocket::{WebSocketService, WebSocketStatus, WebSocketTask};
type AsBinary = bool;
pub enum Format {
Json,
Toml,
}
pub enum WsAction {
Connect,
SendData(AsBinary),
Disconnect,
Lost,
}
pub enum Msg {
WsAction(WsAction),
WsReady(Result<WsResponse, Error>),
}
impl From<WsAction> for Msg {
fn from(action: WsAction) -> Self {
Msg::WsAction(action)
}
}
/// This type is used as a request which sent to websocket connection.
#[derive(Serialize, Debug)]
struct WsRequest {
value: u32,
}
/// This type is an expected response from a websocket connection.
#[derive(Deserialize, Debug)]
pub struct WsResponse {
value: u32,
}
pub struct Model {
pub fetching: bool,
pub data: Option<u32>,
pub ws: Option<WebSocketTask>,
}
impl Model {
fn view_data(&self) -> Html {
if let Some(value) = self.data {
html! {
<p>{ value }</p>
}
} else {
html! {
<p>{ "Data hasn't fetched yet." }</p>
}
}
}
}
impl Component for Model {
type Message = Msg;
type Properties = ();
fn create(ctx: &Context<Self>) -> Self {
Self {
fetching: false,
data: None,
ws: None,
}
}
fn update(&mut self, ctx: &Context<Self>, msg: Self::Message) -> bool {
match msg {
Msg::WsAction(action) => match action {
WsAction::Connect => {
let callback = ctx.link().callback(|Json(data)| Msg::WsReady(data));
let notification = ctx.link().batch_callback(|status| match status {
WebSocketStatus::Opened => None,
WebSocketStatus::Closed | WebSocketStatus::Error => {
Some(WsAction::Lost.into())
}
});
let task = WebSocketService::connect(
"wss://echo.websocket.events/",
callback,
notification,
)
.unwrap();
self.ws = Some(task);
true
}
WsAction::SendData(binary) => {
let request = WsRequest { value: 321 };
if binary {
self.ws.as_mut().unwrap().send_binary(Json(&request));
} else {
self.ws.as_mut().unwrap().send(Json(&request));
}
false
}
WsAction::Disconnect => {
self.ws.take();
true
}
WsAction::Lost => {
self.ws = None;
true
}
},
Msg::WsReady(response) => {
self.data = response.map(|data| data.value).ok();
true
}
}
}
fn view(&self, ctx: &Context<Self>) -> Html {
html! {
<div>
<nav class="menu">
{ self.view_data() }
<button disabled={self.ws.is_some()}
onclick={ctx.link().callback(|_| WsAction::Connect)}>
{ "Connect To WebSocket" }
</button>
<button disabled={self.ws.is_none()}
onclick={ctx.link().callback(|_| WsAction::SendData(false))}>
{ "Send To WebSocket" }
</button>
<button disabled={self.ws.is_none()}
onclick={ctx.link().callback(|_| WsAction::SendData(true))}>
{ "Send To WebSocket [binary]" }
</button>
<button disabled={self.ws.is_none()}
onclick={ctx.link().callback(|_| WsAction::Disconnect)}>
{ "Close WebSocket connection" }
</button>
</nav>
</div>
}
}
}
fn main() {
yew::Renderer::<Model>::new().render();
}
Dependencies
~12–20MB
~278K SLoC