Como converter um PDF em um arquivo de imagem no Node.js

Como faço para instalar o IronPDF for Node.js?

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

Instale o pacote Node.js do IronPDF a partir do npm para converter PDFs em PNG, JPG, GIF, BMP e outros formatos de imagem.

Antes de converter PDFs em imagens na produção, configure sua chave de licença. O pacote também exige que o IronPDF Engine seja instalado em seu sistema — este binário lida com todas as operações de renderização de PDF e deve estar presente para que a conversão funcione.

Como faço para converter um PDF em uma imagem?

O método rasterizeToImageFiles lê um documento PDF e grava um arquivo de imagem por página no caminho de saída fornecido. Para PDFs de página única, ele produz exatamente uma imagem. Para PDFs de múltiplas páginas, ele adiciona um sufixo de número de página a cada nome de arquivo automaticamente.

O exemplo abaixo carrega um PDF de exemplo do Learning Container e o converte em um arquivo PNG.

O arquivo PDF de exemplo aberto em um visualizador. Baixe este arquivo e outros PDFs de teste do Learning Container.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-png.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Load the PDF and convert it to a PNG image.
// The output path determines the format — change .png to .jpg for JPEG output.
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/sample-pdf-file.png");
    return pdf;
}).catch((error) => {
    console.error("Error converting PDF to image:", error);
});

PdfDocument.fromFile carrega o PDF e retorna uma Promise que resolve para um objeto PdfDocument. A função de retorno .then recebe o documento resolvido e chama rasterizeToImageFiles com o caminho de destino. A extensão do arquivo no caminho — .png neste caso — indica ao IronPDF qual formato gerar. O bloco .catch trata quaisquer erros de leitura ou conversão.

O PNG gerado a partir do PDF de exemplo acima. IronPDF converte o documento em três linhas de código.

Para exemplos mais detalhados das opções deste método, veja a página de exemplo de código PDF para Imagens.

Como converto um PDF no formato JPEG?

A seleção do formato é automática: qualquer extensão que você passar para rasterizeToImageFiles determinará o formato de saída. Para produzir um JPEG em vez de um PNG, altere a extensão no caminho de destino:

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-extension.js
// Switch to JPEG by changing the file extension in the output path.
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

Quando o nome do arquivo de saída não puder ser controlado — por exemplo, em pipelines automatizados com esquemas de nomenclatura fixos — passe um valor ImageType no objeto de opções para substituir a detecção baseada em extensão:

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-imagetype.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// ImageType.JPG forces JPEG output regardless of the file extension.
const options = {
    type: ImageType.JPG,
    dpi: 300
};
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/output.png", options);
    return pdf;
});

A propriedade type no objeto de opções tem precedência sobre a extensão do nome do arquivo. No exemplo acima, rasterizeToImageFiles produz um arquivo JPEG mesmo que o caminho de destino termine com .png. O mesmo padrão se aplica a saídas GIF e BMP.

Como converto um PDF de várias páginas em imagens?

Para documentos com mais de uma página, rasterizeToImageFiles cria uma imagem por página. IronPDF adiciona um índice de página baseado em zero a cada nome de arquivo de saída, mantendo a saída organizada sem código adicional de sua parte.

Um exemplo de PDF de duas páginas. IronPDF cria um arquivo de imagem por página durante a conversão.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-multipage.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Each page of the PDF becomes a separate image file.
// Output filenames: multipage-pdf-page_1.png, multipage-pdf-page_2.png, etc.
PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});

Os dois arquivos PNG produzidos a partir do PDF de duas páginas. IronPDF nomeia cada arquivo de saída com seu número de página.

Esse comportamento automático de divisão de página funciona com todos os formatos de imagem suportados. Combine-o com a opção fromPages na próxima seção para converter apenas páginas específicas de documentos grandes. Para trabalhar na direção oposta, o exemplo de imagem para PDF mostra como combinar vários arquivos de imagem em um único documento PDF.

Como converto apenas páginas específicas?

A propriedade fromPages no objeto de opções aceita uma matriz de índices de página com base zero. Apenas as páginas especificadas são rasterizadas; todas as outras são ignoradas. Isso é útil quando se trabalha com PDFs grandes onde apenas um subconjunto de páginas é necessário — por exemplo, extraindo páginas de capa e início de seção para visualização de documentos. Quando você precisar trabalhar com páginas individuais antes de convertê-las, a referência da API do Node.js para PdfDocument documenta operações adicionais em nível de página.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-selective-pages.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert only pages 1, 4, 6, and 9 (zero-indexed: 0, 3, 5, 8) to BMP.
const options = {
    type: ImageType.BMP,
    fromPages: [0, 3, 5, 8],
    dpi: 150
};
PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles(
        "./images/multipage-selective-pdf/multipage-pdf-page.bmp",
        options
    );
}).catch((error) => {
    console.error("Failed to convert pages:", error);
});

O IronPDF rasterizou apenas as quatro páginas especificadas na matriz fromPages. As outras páginas não foram processadas.

Os índices de página em fromPages são baseados em zero, portanto [0, 3, 5, 8] tem como alvo a primeira, quarta, sexta e nona páginas. O valor de 150 DPI equilibra a qualidade da saída contra o tamanho do arquivo — adequado para casos de uso de arquivo ou visualização. A conversão seletiva é compatível com todos os tipos de imagem suportados.