references/useWebWorker.md
GitHub| category | Browser |
| related | useWebWorkerFn |
useWebWorker
Simple Web Workers registration and communication.
Usage
import { useWebWorker } from '@vueuse/core'
const { data, post, terminate, worker } = useWebWorker('/path/to/worker.js')
| State |
Type |
Description |
| data |
Ref<any> |
Reference to the latest data received via the worker, can be watched to respond to incoming messages |
| worker |
ShallowRef<Worker | undefined> |
Reference to the instance of the WebWorker |
| Method |
Signature |
Description |
| post |
(message: any, transfer: Transferable[]): void
(message: any, options?: StructuredSerializeOptions | undefined): void |
Sends data to the worker thread. |
| terminate |
() => void |
Stops and terminates the worker. |
Type Declarations
type PostMessage = (typeof Worker.prototype)["postMessage"]
export interface UseWebWorkerReturn<Data = any> {
data: Ref<Data>
post: PostMessage
terminate: () => void
worker: ShallowRef<Worker | undefined>
}
type WorkerFn = (...args: unknown[]) => Worker
export declare function useWebWorker<T = any>(
url: string,
workerOptions?: WorkerOptions,
options?: ConfigurableWindow,
): UseWebWorkerReturn<T>
export declare function useWebWorker<T = any>(
worker: Worker | WorkerFn,
): UseWebWorkerReturn<T>