Web Workers

Docs는 UniverDocsLayoutWorkerPlugin으로 문서 레이아웃을 Web Worker1에서 계산할 수 있습니다. Docs 핵심 플러그인 다음에 등록하고 workerFactory로 레이아웃 서비스의 새 Worker를 만드세요.

먼저 설치 및 기본 사용법을 완료하세요. 아래 코드는 기존 설정을 확장합니다. 콘텐츠를 만들거나 불러오기 전에 플러그인을 등록하고, 이미 등록한 플러그인은 중복 등록하지 말고 설정을 수정하세요.

메인 스레드

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

Worker 진입점

TypeScript
import { startDocsLayoutWorker } from '@univerjs/docs'startDocsLayoutWorker()

모듈 Worker와 별도 진입점 파일을 사용하세요. Worker와 메인 스레드의 패키지 버전을 맞춰야 합니다. 렌더링과 사용자 상호 작용은 메인 스레드에서 처리합니다.

Footnotes

  1. Web Worker는 브라우저의 메인 스레드 밖에서 JavaScript를 실행하고 메시지로 통신합니다. 페이지 DOM에 직접 접근할 수 없으며, 계산을 Worker로 옮겨도 편집기 UI가 함께 이동하지는 않습니다. ↩

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.