Web Workers

Bases 可以通过 RPC 把公式计算交给 Worker1 执行。在主线程的公式引擎上设置 notExecuteFormula: true,并在 Worker 中注册远程 Bases 插件和负责公式计算的引擎。

本页从安装和基本使用开始,下面的代码在该配置的基础上继续扩展。插件必须在创建或加载内容之前注册;如果已有注册,应替换原有注册,不要重复注册同一个插件。

主线程

UniverRPCMainThreadPlugin

  • workerURL
    string | URL | Worker
    把编辑器连接到执行公式计算的 Worker。

UniverProFormulaEnginePlugin

  • notExecuteFormula
    boolean默认值: false
    公式交给 Worker 计算时,主线程跳过公式计算。
TypeScript
import { UniverProFormulaEnginePlugin } from '@univerjs-pro/engine-formula'import { UniverRPCMainThreadPlugin } from '@univerjs/rpc'univer.registerPlugin(UniverRPCMainThreadPlugin, {  workerURL: new Worker(new URL('./worker.ts', import.meta.url), { type: 'module' }),})univer.registerPlugin(UniverProFormulaEnginePlugin, { notExecuteFormula: true })

Worker 入口

UniverLicensePlugin

  • license
    string
    客户端许可证文件的内容。
TypeScript
import { UniverRemoteBasesPlugin } from '@univerjs-pro/bases/worker'import { UniverProFormulaEnginePlugin } from '@univerjs-pro/engine-formula/worker'import { UniverLicensePlugin } from '@univerjs-pro/license'import { LocaleType, Univer } from '@univerjs/core'import { UniverRPCWorkerThreadPlugin } from '@univerjs/rpc/worker'const univer = new Univer({ locale: LocaleType.ZH_CN })univer.registerPlugin(UniverLicensePlugin, { license: 'your license.txt' })univer.registerPlugin(UniverProFormulaEnginePlugin)univer.registerPlugin(UniverRemoteBasesPlugin)univer.registerPlugin(UniverRPCWorkerThreadPlugin)

使用模块类型的 Worker,并为其提供独立的入口文件。Worker 与主线程的包版本必须保持一致,渲染和用户交互仍然留在主线程。

透视视图与仪表盘

如需在 Worker 中执行仪表盘的透视计算,在主线程的 UniverBaseDashboardPlugin 上设置 notExecuteCalculation: true,并在同一个 Worker 中注册 UniverRemoteBaseDashboardPlugin。仪表盘的 UI 插件留在主线程。

UniverBaseDashboardPlugin

  • notExecuteCalculation
    boolean
    把仪表盘的透视计算移出主线程。使用远程仪表盘插件时设为 true。
TypeScript
import { UniverBaseDashboardPlugin } from '@univerjs-pro/bases-dashboard'univer.registerPlugin(UniverBaseDashboardPlugin, { notExecuteCalculation: true })
TypeScript
import { UniverRemoteBaseDashboardPlugin } from '@univerjs-pro/bases-dashboard/worker'univer.registerPlugin(UniverRemoteBaseDashboardPlugin)

Footnotes

  1. Web Worker 在浏览器主线程之外执行 JavaScript,通过消息与主线程通信,不能直接访问页面 DOM。把计算放入 Worker 并不意味着把编辑器界面也迁入其中。 ↩

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.