@embedpdf/pdfium

中文文档
2.15.1发布于 2026/09/17MITTypeScriptESM + CJS零依赖近 30 天下载 522.1万

PDFium Web Assembly for the web 平台的PDFium Web Assembly. 页面存档备份,存于互联网档案馆. 这个软件包为PDFium提供了强大的JavaScript接口,使得高品质的PDF渲染和操作直接在网络应用中实现.

中文使用文档
文档目录7 节
  1. 文档
  2. 何为PDFium?
  3. 特征
  4. 安装
  5. 基本用途
  6. 学习更多
  7. 许可证
EmbedPDF logo

嵌入式PDF

NPM version License Join the community on GitHub

@embedpdf/pdfium (英语)

PDFium Web Assembly for the web 平台的PDFium Web Assembly. 页面存档备份,存于互联网档案馆. 这个软件包为PDFium提供了强大的JavaScript接口,使得高品质的PDF渲染和操作直接在网络应用中实现.

文档

关于完整的文件、实例和API,请访问:

正式文件

何为PDFium?

PDFium是一个开源的PDF渲染引擎,最初由Foxit Software开发,后由Google作为开源发布. 以 C++ 写成,是同一引擎在Chrome 和许多其他应用中赋予PDF查看权力. 这个软件包通过WebAssembly给浏览器带来了本土质量的PDF能力,而不需要任何服务器侧处理.

特征

  • PDF 页面的高可靠性渲染
  • 文本提取和搜索
  • 表格填充和操纵
  • 注释支持
  • 数字签字核查
  • PDF 修改和创建

安装

# npm
npm install @embedpdf/pdfium

# pnpm
pnpm add @embedpdf/pdfium

# yarn
yarn add @embedpdf/pdfium

# bun
bun add @embedpdf/pdfium

基本用途

import { init, WrappedPdfiumModule } from '@embedpdf/pdfium';

const pdfiumWasm =
  'https://cdn.jsdelivr.net/npm/@embedpdf/pdfium/dist/pdfium.wasm';

let pdfiumInstance = null;

async function initializePdfium() {
  if (pdfiumInstance) return pdfiumInstance;

  const response = await fetch(pdfiumWasm);
  const wasmBinary = await response.arrayBuffer();
  pdfiumInstance = await init({ wasmBinary });

  // Initialize the PDFium extension library
  // This is required before performing any PDF operations
  pdfiumInstance.PDFiumExt_Init();

  return pdfiumInstance;
}

// Usage
async function renderPdf() {
  const pdfium = await initializePdfium();
  // Use pdfium to load and render PDFs
  // See documentation for detailed examples
}

学习更多

检查我们的全面文件 嵌入式pdf.com/docs/pdfium 用于:

  • 详细 API 参考
  • 代码示例
  • 最佳做法
  • 高级用途

许可证

这个包裹根据麻省理工学院的许可证颁发——见 自由主义 详细文件.

还有捆绑 PDF ium 以网络大会形式,
根据该条例获得许可的 Apache 许可证,2.0版本。 。 。 .

版本与发布记录

@embedpdf/pdfium 共发布 89 个版本,首次发布于 2025/03/19;过去 12 个月发布了 37 个版本。

版本发布日期距今
2.15.1latest2026/09/171 个月前
2.15.02026/08/053 个月前
2.14.42026/06/085 个月前
2.14.32026/05/205 个月前
2.14.22026/04/306 个月前
2.14.12026/04/226 个月前

其他发布通道:alpha → 1.0.0-alpha.1,next → 2.0.0-next.3。

关于 @embedpdf/pdfium 的常见问题

@embedpdf/pdfium 是什么?

PDFium Web Assembly for the web 平台的PDFium Web Assembly. 页面存档备份,存于互联网档案馆. 这个软件包为PDFium提供了强大的JavaScript接口,使得高品质的PDF渲染和操作直接在网络应用中实现.

如何安装 @embedpdf/pdfium?

在项目目录运行 npm install @embedpdf/pdfium,或使用 pnpm add / yarn add / bun add。

@embedpdf/pdfium 支持 TypeScript 吗?

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

@embedpdf/pdfium 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@embedpdf/pdfium 可以商用吗?

@embedpdf/pdfium 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@embedpdf/pdfium 的下载量有多少?

根据 npm 官方下载统计,@embedpdf/pdfium 在 2026/10/14 – 2026/11/12 这 30 天内被下载 5,220,594 次,日均约 174,020 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@embedpdf/pdfium 还在维护吗?

最新版本 2.15.1 发布于 2026/09/17(1 个月前);至今共发布 89 个版本,其中过去 12 个月发布了 37 个;首次发布于 2025/03/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。