コンテンツへスキップ

useWebWorkerFn

カテゴリ
エクスポートサイズ
749 B
最終変更日
先週
関連

Promise を使用したシンプルな構文で、UI をブロックせずに高負荷な関数を実行します。 alewin/useWorker の移植版です。

デモ

現在時刻: 2024-11-28 03:59:09 732

これは、Web Worker の有無にかかわらず、大規模な配列(500万個の数値)のソートを示すデモです。
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>

ソースコード

ソースコードデモドキュメント

コントリビューター

Anthony Fu
Fabian
Anthony Fu
wheat
sibbng
Antério Vieira
thefeymesaleng
Luvoy
Hawtim
烽宁
Jelf
不見月
Shinigami
Alex Kozack
Richard Musiol

変更ログ

v12.0.0-beta.1 2024年11月21日
0a9ed - feat!: Vue 2サポートの削除、バンドルの最適化、クリーンアップ (#4349)
v10.10.0 2024年5月27日
f4028 - feat: ローカル関数依存関係のサポート (#3899)
v10.7.0 2023年12月5日
fccf2 - feat: 依存関係のアップグレード (#3614)
v10.4.0 2023年8月25日
34206 - fix(useWebWorker): エラーイベントのバブリングの防止 (#3141)

MITライセンスの下でリリースされています。