rustedf.cloud
Menu

HTML para PDF: biblioteca, navegador headless ou API? Como escolher

Publicado em 4 min de leitura

Há três jeitos comuns de transformar HTML em PDF: uma biblioteca dentro da sua aplicação, um navegador que você roda sem tela e uma API que faz o trabalho em outro lugar. Nenhum deles é a resposta certa para todo projeto. Este guia compara os três no que você precisa rodar, no HTML e no CSS que você recebe e no destino do documento, e termina com as perguntas que decidem.

Os três jeitos

Uma biblioteca na sua aplicação. Você adiciona um pacote e o chama. Ela monta o HTML e o CSS com o seu próprio motor, então pode ser pequena e rápida de começar. Costuma suportar um subconjunto do CSS, e o que fica fora dele é você quem contorna. Ela roda no seu processo, com a memória e as falhas que isso traz, e é você quem a mantém atualizada.

Um navegador headless. Você roda um navegador de verdade sem janela e pede que ele imprima uma página. Você recebe o suporte a HTML e CSS do navegador, incluindo JavaScript. Em troca, instala o navegador em cada ambiente, dá memória e tempo a cada documento e o mantém atualizado. Em volume, você administra um conjunto de navegadores, filas e reinícios.

Uma API. Você envia o HTML e os dados em uma requisição e recebe um PDF. Não há nada para instalar nem para manter rodando, e o custo cresce com o número de documentos. O documento e os seus dados saem da sua infraestrutura, você depende de o serviço estar disponível, e os limites dele (o tamanho de uma requisição, as páginas de um documento, a taxa de chamadas) valem para você.

O que cada um pede de você

Aspecto Biblioteca Navegador headless API
O que você roda Um pacote na sua app Um navegador em cada ambiente Nada, uma chamada de cliente
HTML e CSS que você recebe O que o motor suporta O que o navegador suporta O que o serviço suporta
JavaScript ao gerar Em geral não Sim Depende do serviço
Para onde vão os dados Ficam com você Ficam com você Vão ao serviço
Quem atualiza Você Você O serviço
O custo cresce com Os seus servidores Os seus servidores O número de documentos

Onde o rustedf.cloud se encaixa

É o terceiro jeito, e tem limites claros. Os documentos são montados para o papel: páginas, tabelas que seguem por várias páginas, cabeçalhos e rodapés, número de página. Ele suporta um subconjunto definido de HTML e CSS e não executa JavaScript. As imagens precisam ser enviadas para a sua conta ou embutidas como URLs data:, porque o serviço nunca busca um endereço vindo de um template. Tudo o que fica fora do subconjunto é ignorado e reportado, e um endpoint de validação diz o quê antes de você enviar.

Em troca, você tem nenhum navegador para rodar, templates com pré-visualização ao vivo em um portal, formatação de números, moedas e datas para qualquer idioma, e uma geração que falha sem custo.

Perguntas que decidem

  • Os seus documentos precisam de JavaScript para serem montados? Se um gráfico ou um layout é desenhado por um script, você precisa de um navegador ou de algo que o execute. Uma API baseada em templates não serve.
  • Os dados precisam ficar dentro da sua infraestrutura? Se um contrato ou uma norma exige, use uma biblioteca ou o seu próprio navegador.
  • Quantos documentos, e com que regularidade? Alguns milhares por mês, em rajadas, combinam bem com uma API. Um volume muito grande e constante pode sair mais barato rodando você mesmo.
  • Quem vai manter isso rodando? Se ninguém na equipe quer cuidar de um conjunto de navegadores, esse é um custo que não aparece na primeira semana.
  • Quanto da página web precisa ser reproduzido? Uma fatura, um orçamento, um relatório ou um certificado cabem no subconjunto voltado ao papel. Uma página copiada de uma aplicação web complexa talvez não.

Se a maioria das respostas aponta para “documentos montados a partir de dados, pensados para o papel, nada para manter”, teste a API com um documento real e valide-o. O plano grátis serve exatamente para isso.

Leia HTML e CSS suportados e Gerar um PDF.

  • Primeiros passos

    HTML e CSS para PDF: o que funciona e como conferir

    Um PDF é paginado, não rolado. Veja quais HTML e CSS um gerador de PDF suporta, o que deixar de fora e como validar um documento antes de enviar.

    3 min de leitura

  • Primeiros passos

    Como gerar fatura em PDF com uma API

    Monte um template de fatura com itens em loop, moeda e data por país, e gere o PDF com uma requisição. Exemplo completo em HTML e curl.

    2 min de leitura

  • Código e integrações

    Gerar PDF no ASP.NET Core: MVC, Razor Pages e minimal APIs

    Transforme uma view Razor em PDF no ASP.NET Core com uma chamada de API: renderizador de views, view pronta para impressão, action MVC e handler do Razor Pages.

    3 min de leitura

← Todos os posts