Web Worker transport
WebWorkerTransport is used for communication between a host page (or host worker) and a Web Worker.
It uses the worker’s postMessage method and onmessage events (and their equivalents in worker context - DedicatedWorkerGlobalScope.postMessage and DedicatedWorkerGlobalScope.onmessage) to exchange messages.
WebWorkerTransport::new(worker, codec).awaitcreates a transport for the worker on the host side.WebWorkerTransport::new_with_name(worker, codec, name).awaitcreates a named transport for the worker on the host side.WebWorkerTransport::new_in_worker(codec).awaitcreates a transport inside the worker.WebWorkerTransport::new_with_name_in_worker(codec, name).awaitcreates a named transport inside the worker.
Note
new_in_workerandnew_with_name_in_workermust be called inside a worker context,Error::NotInWorkeris returned otherwise.
Named transports are useful when the host or worker needs multiple channels. Multiple named transports can be used simultaneously alongside an unnamed transport in the same page or worker.
Workers can themselves host nested workers and use WebWorkerTransport::new(...) from within a worker context to create transports to child workers.
This transport is appropriate when you want a direct worker-host channel. If you need to use a dedicated MessagePort or send transferable objects, see the MessagePort and Transferable transport sections.
Host example
use futures::SinkExt;
use dnet::{codecs::BincodeCodec, webworker::WebWorkerTransport, Receive};
use web_sys::{Worker, WorkerOptions, WorkerType};
let options = WorkerOptions::new();
options.set_type(WorkerType::Module);
let worker = Worker::new_with_options("./worker.js", &options).unwrap();
let mut transport = WebWorkerTransport::new(worker, BincodeCodec::default()).await?;
transport.send("hello from host".to_string()).await?;
let reply: String = transport.receive().await?;
Worker example
use futures::SinkExt;
use dnet::{codecs::BincodeCodec, webworker::WebWorkerTransport, Receive};
let mut transport = WebWorkerTransport::new_in_worker(BincodeCodec::default()).await?;
let request: String = transport.receive().await?;
transport.send(format!("hello from worker: {}", request)).await?;