pdfium：功能强大的 TypeScript/JavaScript PDF 解析库

pdfium：功能强大的 TypeScript/JavaScript PDF 解析库

在现代化的网页应用与服务器端开发中，处理 PDF 文档的需求日益增长。今天，我将向您推荐一个开源项目——pdfium，这是一个基于 TypeScript/JavaScript 的 PDF 解析库，它拥有丰富的功能，适用于多种开发场景。

项目介绍

pdfium 是一个针对 PDFium 库的 TypeScript/JavaScript 封装。PDFium 是由 Google 开发并用于 Chrome 浏览器的开源库，它支持 PDF 文档的解析和渲染。pdfium 通过将 PDFium 库编译为 WebAssembly，并将其与封装代码一起打包，为开发者提供了一种在浏览器和 Node.js 环境中处理 PDF 文档的便捷方式。

项目技术分析

pdfium 的核心是 PDFium 库，这个库使用 C++ 编写，经过编译转化为 WebAssembly 格式。这种架构带来了一系列的技术优势：

• 零依赖性：由于 PDFium 库已经编译为 WebAssembly 并内置于包中，开发者无需安装任何额外的库即可使用。
• 高性能：与纯 JavaScript 编写的 PDF.js 相比，pdfium 的性能更优，因为 C++ 的执行效率通常高于 JavaScript。
• 类型安全：包含 TypeScript 定义，确保了代码的类型安全。

项目及技术应用场景

pdfium 适用于多种开发场景，以下是一些典型应用案例：

1. 网页应用：在网页应用中嵌入 PDF 阅读器，让用户能够查看和打印 PDF 文档，同时支持搜索、缩放等常见功能。
2. 服务器端应用：在服务器端处理 PDF 文档，如自动提取文本、生成缩略图或转换页面为图片等。
3. 自动化工具：集成于自动化测试或数据处理流程中，用于解析 PDF 文件内容，支持数据验证和报告生成。

使用方法

使用 pdfium 前，首先需要通过 npm 进行安装：

npm install @hyzyla/pdfium

以下是使用 pdfium 读取 PDF 文档并将其页面转换为 PNG 图片的一个简单示例：

import { PDFiumLibrary } from "@hyzyla/pdfium";
import { promises as fs } from 'fs';
import sharp from 'sharp';

async function renderFunction(options: PDFiumPageRenderOptions) {
  return await sharp(options.data, {
    raw: {
      width: options.width,
      height: options.height,
      channels: 4,
    },
  })
    .png()
    .toBuffer();
}

async function main() {
  const buff = await fs.readFile('test2.pdf');
  const library = await PDFiumLibrary.init();
  const document = await library.loadDocument(buff);
  
  for (const page of document.pages()) {
    console.log(`${page.number} - rendering...`);
    const image = await page.render({
      scale: 3,
      render: renderFunction,
    });
    await fs.writeFile(`output/${page.number}.png`, Buffer.from(image.data));
  }

  document.destroy();
  library.destroy();
}

main();

项目特点

pdfium 作为一款功能强大的 PDF 解析库，具有以下显著特点：

1. 跨平台：无论是在浏览器还是在 Node.js 环境中，pdfium 都能够稳定运行。
2. 高性能：基于 WebAssembly 的设计使得 pdfium 在处理 PDF 文档时，性能更为出色。
3. 易于使用：简洁的 API 设计，使得开发者能够快速上手并集成到项目中。

通过以上介绍，您是否已经对 pdfium 有了更深入的了解呢？如果您正面临 PDF 文档处理的挑战，不妨尝试一下 pdfium，相信它会成为您的得力助手。