useWebWorkerFn
Promise を使用したシンプルな構文で、UI をブロックせずに高負荷な関数を実行します。 alewin/useWorker の移植版です。
デモ
現在時刻: 2024-11-28 03:59:09 732
これは、Web Worker の有無にかかわらず、大規模な配列(500万個の数値)のソートを示すデモです。
UI ブロックが発生すると時計が停止します。
UI ブロックが発生すると時計が停止します。
使用方法
基本例
js
import { useWebWorkerFn } from '@vueuse/core'
const { workerFn } = useWebWorkerFn(() => {
// some heavy works to do in web worker
})
依存関係あり
ts
import { useWebWorkerFn } from '@vueuse/core'
const { workerFn, workerStatus, workerTerminate } = useWebWorkerFn(
dates => dates.sort(dateFns.compareAsc),
{
timeout: 50000,
dependencies: [
'https://cdnjs.cloudflare.com/ajax/libs/date-fns/1.30.1/date_fns.js', // dateFns
],
},
)
ローカル依存関係あり
ts
import { useWebWorkerFn } from '@vueuse/core'
const pow = (a: number) => a * a
const { workerFn, workerStatus, workerTerminate } = useWebWorkerFn(
numbers => pow(numbers),
{
timeout: 50000,
localDependencies: [pow]
},
)
js
import { useWebWorkerFn } from '@vueuse/core'
const pow = (a) => a * a
const { workerFn, workerStatus, workerTerminate } = useWebWorkerFn(
(numbers) => pow(numbers),
{
timeout: 50000,
localDependencies: [pow],
},
)
Web Worker
この関数を使用する前に、Web Worker のドキュメントを読むことをお勧めします。
クレジット
この関数は、Alessio Koci による https://github.com/alewin/useWorker の Vue への移植版であり、@Donskelle の協力を得て移行されました。
型宣言
型宣言を表示
typescript
export type WebWorkerStatus =
| "PENDING"
| "SUCCESS"
| "RUNNING"
| "ERROR"
| "TIMEOUT_EXPIRED"
export interface UseWebWorkerOptions extends ConfigurableWindow {
/**
* Number of milliseconds before killing the worker
*
* @default undefined
*/
timeout?: number
/**
* An array that contains the external dependencies needed to run the worker
*/
dependencies?: string[]
/**
* An array that contains the local dependencies needed to run the worker
*/
localDependencies?: Function[]
}
/**
* Run expensive function without blocking the UI, using a simple syntax that makes use of Promise.
*
* @see https://vueuse.dokyumento.jp/useWebWorkerFn
* @param fn
* @param options
*/
export declare function useWebWorkerFn<T extends (...fnArgs: any[]) => any>(
fn: T,
options?: UseWebWorkerOptions,
): {
workerFn: (...fnArgs: Parameters<T>) => Promise<ReturnType<T>>
workerStatus: Ref<WebWorkerStatus, WebWorkerStatus>
workerTerminate: (status?: WebWorkerStatus) => void
}
export type UseWebWorkerFnReturn = ReturnType<typeof useWebWorkerFn>