Lzh on GitHub

Web Workers 的简单注册和通信。

使用

import { useWebWorker } from '@vueuse/core'

const { data, post, terminate, worker } = useWebWorker('/path/to/worker.js')
状态类型描述
dataRef<any>通过 Worker 接收到的最新数据的引用,可以监听此引用以响应传入消息。
workerShallowRef<Worker | undefined>WebWorker 实例的引用。
方法签名描述
post(message: any, transfer: Transferable[]): void <br> (message: any, options?: StructuredSerializeOptions | undefined): void向 Worker 线程发送数据
terminate() => void停止并终止 Worker

类型声明

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
/**
 * Simple Web Workers registration and communication.
 *
 * @see https://vueuse.org/useWebWorker
 * @param url
 * @param workerOptions
 * @param options
 */
export declare function useWebWorker<T = any>(
  url: string,
  workerOptions?: WorkerOptions,
  options?: ConfigurableWindow,
): UseWebWorkerReturn<T>
/**
 * Simple Web Workers registration and communication.
 *
 * @see https://vueuse.org/useWebWorker
 * @param worker
 */
export declare function useWebWorker<T = any>(
  worker: Worker | WorkerFn,
): UseWebWorkerReturn<T>