@file-viewer/renderer-pdf 2.1.7 → 2.1.8

package/README.en.md

@@ -39,6 +39,8 @@ const options = {
 }
 ```
 
+When no explicit URL is provided, the renderer first probes `/vendor/pdf/pdf.worker.mjs` from the site root. If the host app did not run `file-viewer-copy-assets`, does not use `@file-viewer/vite-plugin`, or a local dev server falls back to HTML for that path, the renderer lazy-loads the packaged PDF.js worker handler as a compatibility fallback so preview does not fail with `Setting up fake worker failed`. For best performance, full cMap/WASM/standard-font support, or strict offline deployments, still copy viewer assets and point these URLs at real static files.
+
 ## Migration Note
 
 PDF rendering has moved out of `@file-viewer/core` into this package, and `pdfjs-dist` is now declared only by `@file-viewer/renderer-pdf`. Installing core or a standard component package no longer pulls PDF.js; explicitly assemble this renderer when PDF preview is needed, or use `@file-viewer/preset-all`.

package/README.md

@@ -39,6 +39,8 @@ const options = {
 }
 ```
 
+默认未显式配置时，渲染器会先探测站点根路径的 `/vendor/pdf/pdf.worker.mjs`。如果客户项目没有执行 `file-viewer-copy-assets`、没有使用 `@file-viewer/vite-plugin`，或者本地临时服务器把该路径回退成 HTML，PDF renderer 会自动懒加载包内 PDF.js worker handler 作为兼容兜底，避免 `Setting up fake worker failed` 直接中断预览。需要最佳性能、完整 cMap/WASM/standard fonts 或严格离线部署时，仍建议复制 viewer assets 并配置真实静态地址。
+
 ## 迁移说明
 
 PDF 渲染已经从 `@file-viewer/core` 移入本包，`pdfjs-dist` 只由 `@file-viewer/renderer-pdf` 声明。只安装 core 或标准组件包时不会再拉取 PDF.js；需要 PDF 预览时请显式装配本 renderer，或使用 `@file-viewer/preset-all`。

package/dist/pdf.js

@@ -10,6 +10,8 @@ const SCALE_STEP = 0.1;
 const FIT_HORIZONTAL_PADDING = 28;
 const PAGE_BORDER_WIDTH = 18;
 const PDF_EXPORT_MAX_PAGE_PIXELS = 8000000;
+const PDF_WORKER_PROBE_TIMEOUT_MS = 1200;
+let bundledPdfWorkerModulePromise = null;
 // PDF.js viewer CSS references image assets that are not shipped with the
 // on-demand renderer chunk, so keep the preview self-contained and 404-free.
 const normalizedPdfViewerStyle = pdfViewerStyle
@@ -86,6 +88,34 @@ const waitForPaint = (view) => new Promise(resolve => {
     }
     globalThis.setTimeout(resolve, 0);
 });
+const isConfiguredUrl = (value) => {
+    return value !== undefined && value !== null && String(value).trim().length > 0;
+};
+const isJavaScriptLikeResponse = (response) => {
+    var _a;
+    const contentType = ((_a = response.headers.get('content-type')) === null || _a === void 0 ? void 0 : _a.toLowerCase()) || '';
+    return !contentType ||
+        contentType.includes('javascript') ||
+        contentType.includes('ecmascript') ||
+        contentType.includes('application/octet-stream') ||
+        contentType.includes('text/plain');
+};
+const loadBundledPdfWorkerModule = async () => {
+    bundledPdfWorkerModulePromise !== null && bundledPdfWorkerModulePromise !== void 0 ? bundledPdfWorkerModulePromise : (bundledPdfWorkerModulePromise = import('pdfjs-dist/legacy/build/pdf.worker.mjs'));
+    return bundledPdfWorkerModulePromise;
+};
+const installBundledPdfFakeWorker = async () => {
+    var _a;
+    const workerGlobal = globalThis;
+    if ((_a = workerGlobal.pdfjsWorker) === null || _a === void 0 ? void 0 : _a.WorkerMessageHandler) {
+        return;
+    }
+    const workerModule = await loadBundledPdfWorkerModule();
+    workerGlobal.pdfjsWorker = {
+        ...workerGlobal.pdfjsWorker,
+        WorkerMessageHandler: workerModule.WorkerMessageHandler,
+    };
+};
 const resolvePdfWorkerUrl = (options, documentUrl) => {
     return resolveFileViewerPdfAssetUrls(options, documentUrl).workerUrl;
 };
@@ -436,18 +466,76 @@ export default async function renderPdf(buffer, target, context) {
             targetWindow.requestAnimationFrame(writeLegacyCompatiblePageDimensions);
         });
     };
-    const createPdfWorker = () => {
-        if (!(targetWindow === null || targetWindow === void 0 ? void 0 : targetWindow.Worker)) {
-            return null;
+    const canUseResolvedPdfWorkerUrl = async (workerUrl) => {
+        var _a, _b;
+        const fetcher = ((_a = targetWindow.fetch) === null || _a === void 0 ? void 0 : _a.bind(targetWindow)) || ((_b = globalThis.fetch) === null || _b === void 0 ? void 0 : _b.bind(globalThis));
+        const AbortControllerCtor = targetWindow.AbortController || globalThis.AbortController;
+        if (!fetcher || !AbortControllerCtor) {
+            return false;
+        }
+        try {
+            const parsed = new URL(workerUrl, documentRef.baseURI || targetWindow.location.href);
+            if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+                return false;
+            }
+        }
+        catch {
+            return false;
+        }
+        const controller = new AbortControllerCtor();
+        const timer = targetWindow.setTimeout(() => controller.abort(), PDF_WORKER_PROBE_TIMEOUT_MS);
+        try {
+            const response = await fetcher(workerUrl, {
+                method: 'HEAD',
+                cache: 'no-cache',
+                signal: controller.signal,
+            });
+            if (response.ok) {
+                return isJavaScriptLikeResponse(response);
+            }
+            if (response.status !== 405 && response.status !== 501) {
+                return false;
+            }
+            const fallbackResponse = await fetcher(workerUrl, {
+                method: 'GET',
+                cache: 'no-cache',
+                headers: { Range: 'bytes=0-0' },
+                signal: controller.signal,
+            });
+            return (fallbackResponse.ok || fallbackResponse.status === 206) &&
+                isJavaScriptLikeResponse(fallbackResponse);
+        }
+        catch {
+            return false;
+        }
+        finally {
+            targetWindow.clearTimeout(timer);
+        }
+    };
+    const createPdfWorker = async () => {
+        const workerUrl = resolvePdfWorkerUrl(options, documentRef.URL || undefined);
+        const hasExplicitWorkerUrl = isConfiguredUrl(options === null || options === void 0 ? void 0 : options.workerUrl);
+        const shouldUseRealWorker = !!(targetWindow === null || targetWindow === void 0 ? void 0 : targetWindow.Worker) &&
+            (hasExplicitWorkerUrl || await canUseResolvedPdfWorkerUrl(workerUrl));
+        if (shouldUseRealWorker) {
+            GlobalWorkerOptions.workerSrc = workerUrl;
+            try {
+                const worker = PdfJsWorker.create({ name: 'file-viewer-pdf-worker' });
+                await worker.promise;
+                return worker;
+            }
+            catch (error) {
+                console.warn('[file-viewer] PDF Worker 初始化失败，改用包内 PDF.js 兜底。', error);
+            }
         }
-        GlobalWorkerOptions.workerSrc = resolvePdfWorkerUrl(options, documentRef.URL || undefined);
         try {
-            return PdfJsWorker.create({ name: 'file-viewer-pdf-worker' });
+            await installBundledPdfFakeWorker();
         }
         catch (error) {
-            console.warn('[file-viewer] PDF Worker 无法创建，回退到 PDF.js 默认加载策略。', error);
-            return null;
+            console.warn('[file-viewer] PDF.js 包内 worker 兜底加载失败，继续使用 PDF.js 默认策略。', error);
+            GlobalWorkerOptions.workerSrc = workerUrl;
         }
+        return null;
     };
     const resolvePdfSearchWaiters = (state) => {
         const waiters = pdfSearchWaiters;
@@ -889,7 +977,7 @@ export default async function renderPdf(buffer, target, context) {
             if (!(context === null || context === void 0 ? void 0 : context.streamUrl) && !buffer.byteLength) {
                 throw new Error(t('pdf.error.missingSource'));
             }
-            const worker = createPdfWorker();
+            const worker = await createPdfWorker();
             const pdfAssets = resolveFileViewerPdfAssetUrls(options, documentRef.URL || documentRef.baseURI);
             const source = (context === null || context === void 0 ? void 0 : context.streamUrl)
                 ? {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/renderer-pdf",
-  "version": "2.1.7",
+  "version": "2.1.8",
   "private": false,
   "type": "module",
   "description": "Standalone PDF renderer plugin for Flyfish File Viewer powered by PDF.js.",
@@ -54,7 +54,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@file-viewer/core": "^2.1.7",
+    "@file-viewer/core": "^2.1.8",
     "pdfjs-dist": "^6.0.227"
   },
   "devDependencies": {