Serverless redistribution of PDF.js for edge environments
npm install pdfjs-serverlessA redistribution of Mozilla's PDF.js for edge environments, like Cloudflare Workers. It is especially useful for serverless AI applications, where you want to parse PDF documents and extract text content.
This package comes with zero dependencies. The whole export is about 1.4 MB (minified).
> [!NOTE]
> pdfjs-serverless is currently built from PDF.js v5.4.149.
Run the following command to add pdfjs-serverless to your project.
``bashpnpm
pnpm add -D pdfjs-serverless
Usage
> [!TIP]
> For common operations, such as extracting text content or images from PDF files, you can use the
unpdf package. It is a wrapper around pdfjs-serverless and provides a simple API for common use cases.pdfjs-serverless provides the same API as the original PDF.js library. To use any of the PDF.js exports, rename the import to pdfjs-serverless instead of pdfjs-dist:`diff
- import { getDocument } from 'pdfjs-dist'
+ import { getDocument } from 'pdfjs-serverless'
`Examples
$3
`ts
export default {
async fetch(request) {
if (request.method !== 'POST')
return new Response('Method Not Allowed', { status: 405 }) const { getDocument } = await import('pdfjs-serverless')
// Get the PDF file from the POST request body as a buffer
const data = await request.arrayBuffer()
const document = await getDocument({
data: new Uint8Array(data),
useSystemFonts: true,
}).promise
// Get metadata and initialize output object
const metadata = await document.getMetadata()
const output = {
metadata,
pages: []
}
// Iterate through each page and fetch the text content
for (let i = 1; i <= document.numPages; i++) {
const page = await document.getPage(i)
const textContent = await page.getTextContent()
const contents = textContent.items.map(item => item.str).join(' ')
// Add page content to output
output.pages.push({
pageNumber: i,
content: contents
})
}
// Return the results as JSON
return new Response(JSON.stringify(output), {
headers: { 'Content-Type': 'application/json' }
})
}
}
`$3
`ts
import { getDocument } from 'https://esm.sh/pdfjs-serverless'const data = Deno.readFileSync('sample.pdf')
const document = await getDocument({
data,
useSystemFonts: true,
}).promise
console.log(await document.getMetadata())
// Iterate through each page and fetch the text content
for (let i = 1; i <= document.numPages; i++) {
const page = await document.getPage(i)
const textContent = await page.getTextContent()
const contents = textContent.items.map(item => item.str).join(' ')
console.log(contents)
}
`How It Works
rollup.config.ts file. It uses rollup to bundle the PDF.js library into a single file that can be used in serverless environments.The heavy lifting comes from string replacements of the
PDF.js library, i.e. removing browser context references and checks such as typeof window. Additionally, we enforce Node.js compatibility (may sound paradoxical at first, bear with me), i.e. we mock the @napi-rs/canvas module and set the isNodeJS flag to true.PDF.js uses a worker to parse PDF documents. This worker is a separate file that is loaded by the main library. For the serverless build, we need to inline the worker code into the main library.
Finally, some mocks are added to the global scope that are not available in serverless environments, such as
FinalizationRegistry which is not available in Cloudflare Workers.Inspiration
pdf.mjs`, a nodeless build of PDF.js v2.MIT License © 2023-PRESENT Johann Schopplich