# Web Workers

- Human documentation: [https://docs.univer.ai/zh-CN/guides/docs/getting-started/worker](https://docs.univer.ai/zh-CN/guides/docs/getting-started/worker)

- Agent Markdown: [https://docs.univer.ai/zh-CN/guides/docs/getting-started/worker.md](https://docs.univer.ai/zh-CN/guides/docs/getting-started/worker.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [docs/getting-started/worker.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/docs/getting-started/worker.zh-CN.mdx)

---

Docs 可以通过 `UniverDocsLayoutWorkerPlugin` 将文档排版放到 Web Worker 中执行。在 Docs 核心插件之后注册它，使用 `workerFactory` 为排版服务创建新的 Worker。

先完成[安装和基本使用](https://docs.univer.ai/zh-CN/guides/docs/getting-started/installation.md)。以下代码用于扩展已有配置。请在创建或加载内容之前注册插件；已有的插件注册应直接修改，不要重复注册。

## 主线程

```typescript title="main.ts"
import { UniverDocsLayoutWorkerPlugin } from '@univerjs/docs'

univer.registerPlugin(UniverDocsLayoutWorkerPlugin, {
  workerFactory: () => new Worker(new URL('./worker.ts', import.meta.url), { type: 'module' }),
})
```

## Worker 入口

```typescript title="worker.ts"
import { startDocsLayoutWorker } from '@univerjs/docs'

startDocsLayoutWorker()
```

使用模块类型的 Worker 和独立入口文件。Worker 与主线程的包版本需要一致，渲染和用户交互仍在主线程执行。