如何通过CDN正确导入pdf.js?导入后控制台出现报错的解决方法
针对pdf.js 2.7.570 CDN引入报错的修复方案
弃用提示:未指定GlobalWorkerOptions.workerSrc
pdf.js 2.x版本启用了Web Worker隔离解析机制,要求手动配置匹配版本的Worker脚本路径,否则会触发弃用提示,甚至影响后续解析流程。
解决方法:在引入pdf.min.js的脚本标签后,添加Worker配置,版本号必须和引入的核心库完全一致,错配会直接导致解析失败:
pdfjsLib.GlobalWorkerOptions.workerSrc = 'https://cdn.jsdelivr.net/npm/pdfjs-dist@2.7.570/build/pdf.worker.min.js';
类型报错:pdfjsLib.getDocument(...).then is not a function
2.7.570版本中,getDocument()方法返回的是PDFDocumentLoadingTask加载任务实例,并非可直接链式调用的Promise对象。该实例的promise属性才是实际承载加载结果的Promise,直接在返回值上挂载.then方法就会触发类型错误。
解决方法:调整调用逻辑,为getDocument的返回值补充.promise属性访问后再接链式调用。
修改后的完整可运行代码
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> <script src="https://cdn.jsdelivr.net/npm/pdfjs-dist@2.7.570/build/pdf.min.js"></script> </head> <body> <canvas id="my-canvas"></canvas> <script> // 配置Worker路径,消除弃用提示 pdfjsLib.GlobalWorkerOptions.workerSrc = 'https://cdn.jsdelivr.net/npm/pdfjs-dist@2.7.570/build/pdf.worker.min.js'; // 补充.promise访问,解决.then类型报错 pdfjsLib.getDocument('./ahmed.pdf').promise.then(doc => { console.log("this file has" + doc._pdfInfo.numPages); }); </script> </body> </html>
落地注意事项
- 确认本地
ahmed.pdf文件和html页面的相对路径匹配,避免资源404 - 不要直接通过
file://协议打开html测试页面,需要启动本地静态服务访问,否则浏览器的安全策略会拦截本地PDF文件的加载请求 - 如果后续升级pdf.js版本,同步替换核心库、Worker脚本的版本号,避免接口变更导致的兼容问题
内容的提问来源于stack exchange,提问作者omar esmaeel
相关产品推荐
相关产品推荐

