Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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.

Note

new_in_worker and new_with_name_in_worker must be called inside a worker context, Error::NotInWorker is 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?;