@bundled-es-modules/pdfjs-dist

中文文档
3.6.172-alpha.1发布于 2023/05/12Apache-2.0TypeScriptES Module零依赖近 30 天下载 3.3万

mirror of pdfjs-dist, bundled and exposed as ES module

原始使用文档
文档目录5 节
  1. Install
  2. Use
  3. Structure
  4. Background
  5. Building

pdfjs-dist

This is a mirror of pdfjs-dist, bundled and exposed as an ES module

Install

npm install @bundled-es-modules/pdfjs-dist

Use

import pdfjs from "@bundled-es-modules/pdfjs-dist/build/pdf";
import viewer from "@bundled-es-modules/pdfjs-dist/web/pdf_viewer";

pdfjs.GlobalWorkerOptions.workerSrc =
  "@bundled-es-modules/pdfjs-dist/build/pdf.worker.js";

var url = "basicapi.pdf";
var loadingTask = pdfjs.getDocument(url);
//...

Important: Unlike in the original build, the pdfjs.GlobalWorkerOptions.workerSrc is mandatory. We recommend supplying the worker via CDN.

Overview

Structure

├── build/
│   ├── pdf.js                    - display layer
│   └── pdf.worker.js             - core layer
|── types/                        - typescript typings
└── web/
    ├── pdf_viewer.js             - top-level viewer import, containing all necessary setup
    ├── module.js                 - pdf-viewer module, transformed from UMD to ESM
    └── util.js                   - utility module for setup

Background

PDFJS is a library by Mozilla, created to facillitate client-side rendering of PDF documents.

Currently, the primary build for this project is provided as UMD-style modules at pdfjs/pdfjs-dist.

Support for es modules in the main project has been requested here (#10317)

Building

npm i
npm run build

版本与发布记录

@bundled-es-modules/pdfjs-dist 共发布 13 个版本,首次发布于 2018/12/11;过去 12 个月发布了 0 个版本。

版本发布日期距今
3.6.172-alpha.1latest2023/05/123 年前
2.16.1062023/05/123 年前
2.16.1052023/05/123 年前
2.16.105-alpha.22022/10/194 年前
2.16.105-alpha.12022/10/194 年前
2.5.207-rc12021/01/145 年前

关于 @bundled-es-modules/pdfjs-dist 的常见问题

@bundled-es-modules/pdfjs-dist 是什么?

mirror of pdfjs-dist, bundled and exposed as ES module

如何安装 @bundled-es-modules/pdfjs-dist?

在项目目录运行 npm install @bundled-es-modules/pdfjs-dist,或使用 pnpm add / yarn add / bun add。

@bundled-es-modules/pdfjs-dist 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bundled-es-modules/pdfjs-dist 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bundled-es-modules/pdfjs-dist 可以商用吗?

@bundled-es-modules/pdfjs-dist 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@bundled-es-modules/pdfjs-dist 的下载量有多少?

根据 npm 官方下载统计,@bundled-es-modules/pdfjs-dist 在 2026/10/09 – 2026/11/07 这 30 天内被下载 32,982 次,日均约 1,099 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bundled-es-modules/pdfjs-dist 还在维护吗?

最新版本 3.6.172-alpha.1 发布于 2023/05/12(3 年前);至今共发布 13 个版本,其中过去 12 个月发布了 0 个;首次发布于 2018/12/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。