# Web Workers

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

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

- Requested language: `zh-TW`

- Content language: `zh-TW`

- Documentation version: `1.2.0`

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

---

PDFs 支援在 Worker[^web-worker] 中渲染頁面縮圖。向 `UniverPdfsUIPlugin` 傳入 `thumbnailWorkerURL`，Worker 使用 `OffscreenCanvas`。此設定僅適用於縮圖，不會將整個 PDF 編輯器移入 Worker。

先完成[安裝與基本使用](https://docs.univer.ai/zh-TW/guides/pdfs/getting-started/installation.md)。以下程式碼用來擴充既有設定。請在建立或載入內容之前註冊外掛；已有的外掛註冊應直接修改，不要重複註冊。

## 主執行緒

```typescript title="main.ts"
import { UniverPdfsUIPlugin } from '@univerjs-pro/pdfs-ui'

univer.registerPlugin(UniverPdfsUIPlugin, {
  thumbnailWorkerURL: new Worker(new URL('./worker.ts', import.meta.url), { type: 'module' }),
})
```

## Worker 入口

```typescript title="worker.ts"
import { startPdfPageThumbnailWorker } from '@univerjs-pro/pdfs-ui'

startPdfPageThumbnailWorker()
```

使用模組類型的 Worker 與獨立入口檔案。Worker 與主執行緒的套件版本須一致，渲染與使用者互動仍在主執行緒執行。

[^web-worker]: Web Worker 在瀏覽器主執行緒之外執行 JavaScript，透過訊息與主執行緒通訊，無法直接存取頁面 DOM。將計算移入 Worker 不代表將編輯器介面也移入其中。