Deno如何提取PDF文本教程

本教程针对Deno开发者，详细介绍了如何在Deno环境中从远程URL获取PDF文件并提取文本内容。不同于直接使用pdf-lib可能遇到的局限性，本文重点推荐并演示了如何利用Deno对npm模块的兼容性，通过引入pdf-parse库来实现可靠的PDF文本解析。文章提供了完整的示例代码，清晰展示了如何使用fetch API获取PDF数据，并通过pdf-parse解析提取文本，解决了在Deno环境下处理PDF文本提取的难题。同时，本文还强调了Deno版本兼容性、错误处理、性能考量以及文本格式等注意事项，助您在实际应用中高效、稳定地处理PDF数据，适用于Web服务和边缘函数（如Supabase Edge Functions）等场景。

在现代 Web 服务和边缘函数（如 Supabase Edge Functions）中，处理来自外部 URL 的 PDF 文件并提取其文本内容是一项常见的需求。然而，在 Deno 这样的运行时环境中，寻找一个稳定且功能完备的 PDF 处理库可能会遇到挑战。

常见误区：pdf-lib 的局限性

许多开发者在 Deno 中尝试处理 PDF 时，可能会自然而然地考虑使用 pdf-lib。pdf-lib 是一个功能强大的库，主要用于创建、修改和签名 PDF 文档。它提供了加载 PDF、获取页面、甚至处理表单字段（AcroForm）的能力。然而，一个常见的误区是期望 pdf-lib 能够直接支持任意 PDF 内容的通用文本提取。

例如，以下尝试使用 pdf-lib 提取文本的代码段：

import { PDFDocument } from 'https://cdn.skypack.dev/pdf-lib';

async function fetchPDF(url: string): Promise {
    const response = await fetch(url);
    const data = await response.arrayBuffer();
    return new Uint8Array(data);
}

async function readPDFText(url: string): Promise {
    const pdfBytes = await fetchPDF(url);
    const pdfDoc = await PDFDocument.load(pdfBytes);
    const pages = pdfDoc.getPages();

    let text = '';
    for (const page of pages) {
        // 这里的 .extractText() 或 .getTextContent() 方法并不存在或不支持通用文本提取
        // 尝试调用会引发 TypeError: .extractText is not a function
        // const content = await page.extractText();
        // text += content;
    }

    return text;
}

// 实际使用时，上述尝试会遇到 TypeError
// const pdfUrl = 'YOUR_PDF_URL_HERE';
// const pdfText = await readPDFText(pdfUrl);
// console.log(pdfText);

如上述代码所示，尝试调用 page.extractText() 或 page.getTextContent() 方法时，通常会遇到 TypeError: .extractText() is not a function 错误。这是因为 pdf-lib 的设计目标并非通用文本解析，其官方文档和社区讨论也明确指出，它目前不支持从文档中解析纯文本内容（除了 AcroForm 字段）。对于通用文本提取，官方建议考虑使用如 PDF.js 等专门的解析库。

解决方案：利用 pdf-parse 进行文本提取

Deno 运行时的一大优势是其对 npm 模块的良好兼容性，允许我们直接通过 npm: 协议导入并使用绝大多数 npm 包。对于 PDF 文本提取任务，pdf-parse 是一个轻量级且高效的解决方案，它底层依赖于 PDF.js，能够可靠地从 PDF 文件中解析出文本内容。

以下是如何在 Deno 中使用 pdf-parse 从 URL 获取 PDF 并提取文本的完整示例：

import pdf from 'npm:pdf-parse/lib/pdf-parse.js';

/**
 * 从指定 URL 获取 PDF 文件并提取其文本内容。
 * @param pdfUrl PDF 文件的 URL。
 * @returns 提取到的文本内容。
 */
async function extractTextFromPDF(pdfUrl: string): Promise {
    try {
        // 1. 从 URL 获取 PDF 文件的二进制数据
        const response = await fetch(pdfUrl);
        if (!response.ok) {
            throw new Error(`Failed to fetch PDF from ${pdfUrl}: ${response.statusText}`);
        }
        const arrayBuffer = await response.arrayBuffer();

        // 2. 使用 pdf-parse 处理二进制数据并提取文本
        // pdf-parse 函数接受 ArrayBuffer 或 Buffer，并返回包含文本等信息的对象
        const data = await pdf(arrayBuffer);

        // 3. 返回提取到的文本内容
        return data.text;
    } catch (error) {
        console.error("Error extracting text from PDF:", error);
        throw error; // 重新抛出错误以便调用方处理
    }
}

// 示例用法：
const pdfUrl = 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf'; // 替换为你的 PDF URL

try {
    console.log(`正在从 ${pdfUrl} 提取文本...`);
    const pdfText = await extractTextFromPDF(pdfUrl);
    console.log("提取到的 PDF 文本内容:");
    console.log(pdfText);
} catch (e) {
    console.error("无法提取 PDF 文本:", e);
}

代码解析：

1. import pdf from 'npm:pdf-parse/lib/pdf-parse.js';: 这是 Deno 中导入 npm 包的标准方式。pdf-parse 的主入口文件位于其 lib 目录下。
2. fetch(pdfUrl): 使用 Deno 内置的 fetch API 从指定的 URL 获取 PDF 文件的响应。
3. response.arrayBuffer(): 将响应体转换为 ArrayBuffer，这是 pdf-parse 所需的二进制数据格式。
4. await pdf(arrayBuffer): 调用 pdf-parse 库的默认导出函数，传入 ArrayBuffer。该函数会异步解析 PDF 内容，并返回一个包含 text 属性（即提取到的文本）的对象。
5. return data.text: 从解析结果中获取并返回纯文本内容。

注意事项与最佳实践

• Deno 版本兼容性： 确保您的 Deno 版本支持 npm: 协议（通常较新版本都支持）。
• 错误处理： 在实际应用中，务必对网络请求（fetch）和 PDF 解析过程（pdf-parse）进行充分的错误处理，例如检查 response.ok，捕获潜在的解析异常。
• 性能考量： 对于非常大的 PDF 文件，文本提取可能需要一定的时间和内存。在边缘函数等资源受限的环境中，应评估其性能影响。
• 文本格式与布局： pdf-parse 提取的文本通常是原始的、不带格式的文本流。PDF 的复杂布局（如多列、图表中的文本）可能会导致提取的文本顺序或可读性不佳。如果需要更高级的文本结构保留，可能需要更复杂的解析逻辑或专门的工具。
• 替代方案： 如果 pdf-parse 无法满足特定需求（例如，需要解析 PDF 内部的图像文本、更精确的文本定位信息），可以考虑直接集成或调用基于 PDF.js 的更底层解析逻辑，或者探索其他专门的 OCR 解决方案。

总结

在 Deno 环境中从 URL 获取 PDF 并提取文本，关键在于选择正确的库。尽管 pdf-lib 在 PDF 操作方面表现出色，但它并非为通用文本提取而设计。通过利用 Deno 对 npm 模块的兼容性，pdf-parse 提供了一个简单而有效的解决方案，能够帮助开发者轻松实现 PDF 文本内容的自动化提取。遵循本文提供的示例和注意事项，您将能够高效地在 Deno 应用中处理 PDF 数据。

好了，本文到此结束，带大家了解了《Deno如何提取PDF文本教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！