Web Workers

PDFs는 Worker1에서 페이지 썸네일을 렌더링할 수 있습니다. UniverPdfsUIPlugin에 thumbnailWorkerURL을 전달하세요. Worker는 OffscreenCanvas를 사용합니다. 이 설정은 썸네일에만 적용되며 PDF 편집기 전체를 Worker로 옮기지 않습니다.

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

메인 스레드

TypeScript
import { UniverPdfsUIPlugin } from '@univerjs-pro/pdfs-ui'univer.registerPlugin(UniverPdfsUIPlugin, {  thumbnailWorkerURL: new Worker(new URL('./worker.ts', import.meta.url), { type: 'module' }),})

Worker 진입점

TypeScript
import { startPdfPageThumbnailWorker } from '@univerjs-pro/pdfs-ui'startPdfPageThumbnailWorker()

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

Footnotes

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

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.