---
title: "O que é um navegador headless e para que serve?"
description: "Um navegador headless é um navegador real que roda sem janela e é controlado por código. O que continua rodando nele, para que serve e quanto custa."
url: https://proxynet.io/pt-br/blog/what-is-a-headless-browser
date: 2026-11-19
author: "Acar Diveroli"
category: "Web scraping"
lang: pt-BR
---

# O que é um navegador headless e para que serve?

Toda noite, às duas horas, um servidor sem monitor conectado transforma as faturas do dia em arquivos PDF. Ninguém abre um navegador e, mesmo assim, cada fatura passa por um: o modelo HTML carrega, a folha de estilos é aplicada, um pequeno script soma os totais e a página pronta é impressa em um arquivo. Esse navegador nunca mostra uma janela. Ele é um navegador headless, e o mesmo tipo de programa roda testes de ponta a ponta, tira capturas de tela e permite que agentes de IA leiam páginas.

Este artigo explica o que é um navegador headless, o que continua funcionando sem janela, como o modo headless do Chrome funciona hoje, como rodar e controlar um, quanto ele custa em comparação com uma requisição HTTP simples, por que os sites podem tratar navegadores automatizados de outra forma e onde ele é útil. Rodamos os comandos em uma página de teste local e contamos o que vimos.

> **Nota: Resposta rápida**
>
> Um navegador headless é um navegador web real que roda sem janela visível e é controlado por código ou por opções de linha de comando, e não por uma pessoa. O motor continua baixando a página e os recursos dela, montando o DOM, executando JavaScript e calculando o layout; só a interface falta, então o resultado vai para um programa como HTML, captura de tela, PDF ou dados. Chrome, Edge e Firefox têm modo headless, e ferramentas como Playwright, Puppeteer e Selenium os controlam. Ele é usado em testes automatizados, PDFs e capturas de tela, monitoramento, agentes de IA e páginas montadas por JavaScript, e consome bem mais CPU, memória e largura de banda do que uma única requisição HTTP.

## O que é um navegador headless?

Um navegador headless é um navegador web completo que roda sem interface gráfica. A "cabeça" (head) aqui é a parte visível: a janela, a barra de endereços, as abas e os menus. Tire essa parte e sobra o motor que carrega e executa páginas web, aguardando instruções de um script ou da linha de comando.

Ele não é uma imitação simplificada. A documentação do Chrome descreve o modo headless como uma forma de rodar o navegador em um ambiente sem supervisão, e os dois modos compartilham o mesmo código, então uma página é carregada, executa os scripts e é diagramada exatamente como na janela que você usa no dia a dia. Um cliente HTTP como o curl, por outro lado, baixa o arquivo HTML e para por aí: ele nunca executa o JavaScript da página, e tudo o que um script acrescenta depois simplesmente não aparece.

## O que continua funcionando quando a janela some?

Quase tudo continua funcionando; somem só as partes que existem para uma pessoa. Quando um navegador headless abre uma página, ele passa pela mesma sequência de um navegador comum:

1. **Rede.** Ele resolve o domínio, abre uma conexão TLS e pede o HTML, depois cada folha de estilos, script, fonte, imagem e chamada de API que a página solicitar. Cookies e armazenamento funcionam normalmente.
1. **Análise para o DOM.** O HTML vira o DOM (Document Object Model), a árvore viva de elementos que os scripts leem e alteram.
1. **Estilos.** As regras CSS são associadas aos elementos.
1. **JavaScript.** Os scripts rodam, buscam mais dados e reescrevem elementos. Em muitos sites modernos, é esta etapa que coloca o conteúdo de fato na página.
1. **Layout e renderização.** O motor calcula onde cada elemento fica no tamanho de janela definido e pinta o resultado na memória.
1. **Saída.** Em vez de ir para uma tela, o resultado vai para o seu programa: o DOM atual como HTML, uma captura de tela, um PDF ou valores que o seu script lê.

O que falta é a interface e a pessoa diante dela: sem janela, sem barra de endereços, sem mouse. Cliques e teclas chegam como comandos, e diálogos que esperariam por uma pessoa, como uma prévia de impressão, viram instruções diretas do tipo "salve esta página como PDF".

## Como o modo headless do Chrome funciona hoje?

O Chrome headless de hoje é o Chrome de verdade rodando sem exibir as janelas, enquanto a implementação antiga e separada segue existindo como um programa independente chamado `chrome-headless-shell`. Essa divisão explica boa parte dos conselhos confusos que circulam na internet.

Por anos, o modo headless foi uma implementação à parte dentro do binário do Chrome, que não compartilhava o código de navegador do próprio Chrome e por isso se comportava de outro jeito em pequenos detalhes. Segundo a [documentação do modo headless do Chrome](https://developer.chrome.com/docs/chromium/headless), o Chrome agora tem modos headless e headful unificados: a partir do Chrome 112, o Chrome headless cria janelas de plataforma, mas não as exibe, e todas as outras funções ficam disponíveis. A partir do Chrome 132.0.6793.0, o modo antigo deixou de fazer parte do Chrome e é distribuído só como `chrome-headless-shell`, que pode ser baixado no painel do Chrome for Testing.

As bibliotecas escolheram padrões diferentes. No Puppeteer, `headless: true` é o padrão e inicia o modo novo, enquanto `headless: "shell"` seleciona o shell. O Playwright roda em headless por padrão com uma build separada do Chromium headless shell, e o modo novo é ativado pelo canal `chromium`. O Firefox tem modo headless em todas as plataformas desde o Firefox 56, iniciado com `-headless`.

## Como rodar um navegador headless pela linha de comando?

Você acrescenta `--headless` ao comando de inicialização do navegador e mais uma opção que diz qual saída você quer. A [referência de linha de comando do Chrome headless](https://developer.chrome.com/docs/automation-and-testing/headless-cli) documenta `--dump-dom` (imprime o DOM da página depois que os scripts rodaram), `--screenshot` (salva um PNG), `--print-to-pdf` (salva um PDF) e duas opções de tempo, `--timeout` e `--virtual-time-budget`. Nestes exemplos, `chrome` representa o seu programa do Chrome: `google-chrome` no Linux, o caminho completo do `chrome.exe` no Windows.

```bash
# Imprimir o DOM depois que os scripts da página rodaram
chrome --headless --dump-dom https://example.com

# Salvar uma captura de tela em um tamanho de janela escolhido
chrome --headless --window-size=1280,800 --screenshot https://example.com

# Salvar a página como PDF sem o cabeçalho e o rodapé com data e URL
chrome --headless --no-pdf-header-footer --print-to-pdf https://example.com

# Dar aos scripts que dependem de tempo até 5 segundos de tempo virtual antes do dump
chrome --headless --virtual-time-budget=5000 --dump-dom https://example.com
```

Na nossa máquina de teste (Windows 11, Chrome 157), servimos em 127.0.0.1 uma página pequena cuja lista de produtos é preenchida por um script que busca um JSON, e rodamos o Chrome com uma pasta de perfil descartável. O curl devolveu a página com a lista vazia. A primeira execução com `--dump-dom` também: o DOM foi impresso antes mesmo de a requisição do script chegar ao nosso servidor. Com `--virtual-time-budget=5000`, o dump, a captura de tela e o PDF mostraram os três produtos.

Essa é a surpresa mais comum com navegadores headless: "a página carregou" e "o conteúdo está lá" são momentos diferentes. No código, espere pelo elemento ou pela resposta de que você precisa, e não por uma pausa fixa.

## Como um navegador headless é controlado por código?

Um navegador headless é controlado por um protocolo de automação: o seu programa envia comandos como "abra esta URL" ou "tire uma captura de tela" por uma conexão, e o navegador responde e informa eventos. Hoje, três protocolos importam.

- **Chrome DevTools Protocol (CDP).** O protocolo por trás das ferramentas do desenvolvedor do Chrome, disponível em navegadores baseados em Chromium, como Chrome e Edge. Ele funciona sobre um WebSocket e dá acesso de baixo nível às páginas, à rede e ao DOM.
- **WebDriver (clássico).** O padrão do W3C por trás do Selenium: requisição e resposta por HTTP, por meio de um programa driver separado para cada navegador.
- **WebDriver BiDi.** Um protocolo mais recente do W3C com comunicação nos dois sentidos, de modo que o navegador consegue transmitir eventos como mensagens de console e atividade de rede. A [especificação do WebDriver BiDi](https://www.w3.org/TR/webdriver-bidi/) é um rascunho de trabalho (Working Draft) do W3C datado de 13 de novembro de 2026; os protocolos remotos do Firefox são o WebDriver BiDi e o Marionette.

Quando iniciamos o nosso Chrome de teste com `--remote-debugging-port=9333`, `http://127.0.0.1:9333/json/version` respondeu com a versão do navegador, `"Protocol-Version": "1.3"` e um endereço WebSocket para comandos CDP. Desde o Chrome 136, essas opções de depuração são ignoradas na pasta de perfil padrão e exigem um `--user-data-dir` apontando para outro lugar; o Google fez a mudança porque malwares usavam a porta de depuração para ler cookies.

A maioria das pessoas nunca escreve mensagens de protocolo à mão. As bibliotecas cuidam disso: o Puppeteer usa CDP com o Chrome por padrão e WebDriver BiDi com o Firefox, o Playwright controla builds de Chromium, Firefox e WebKit a partir de várias linguagens, e o Selenium usa WebDriver e está migrando a implementação para o WebDriver BiDi. As três rodam em headless ou com janela. As diferenças entre Playwright e Selenium em esperas, proxies e linguagens suportadas estão em [Playwright ou Selenium: qual escolher no seu projeto?](/pt-br/blog/playwright-vs-selenium).

## Headless ou headful: qual é a diferença?

Navegadores headless e headful (com janela) carregam as páginas com o mesmo motor; a diferença está em quem observa e em qual é a saída.

| Aspecto | Headless | Headful |
|---|---|---|
| Janela | Nenhuma na tela | Janela visível |
| Entrada | Comandos vindos de código | Mouse, teclado ou código |
| Saída | DOM, captura, PDF, dados | O que você vê |
| Onde roda | Servidores, CI, contêineres | Um desktop com tela |
| Depuração | Logs, traces, capturas | Ver a página ao vivo |
| Tarefa típica | Testes, PDFs, execuções agendadas | Escrever e depurar scripts |

Na prática, as equipes usam os dois: um teste é depurado em modo headful, para você ver onde um clique cai, e depois roda em headless em um servidor de build sem tela. Se um script se comporta de forma diferente entre os modos, confira primeiro o tempo e o tamanho da janela; uma janela padrão mais estreita pode fazer uma página responsiva mudar para o layout móvel.

## Quanto custa um navegador headless em comparação com uma requisição HTTP?

Um navegador headless custa bem mais do que uma requisição HTTP, porque baixa e executa a página inteira em vez de um único arquivo e mantém um conjunto de processos rodando para isso.

O nosso teste local mostrou a diferença. O curl fez exatamente uma requisição ao nosso servidor de teste; um carregamento de página no Chrome headless fez cinco: o HTML, a folha de estilos, o script, a chamada JSON e o ícone do site. Uma página real de loja aponta para dezenas de imagens, fontes e scripts. Com uma página aberta no Chrome headless, o Windows listou doze processos `chrome.exe` (um processo de navegador, sete renderizadores, um processo de GPU e processos auxiliares), que juntos ocupavam centenas de megabytes de memória.

Por isso, use um navegador só quando a página precisar de um. Se os dados estão no HTML ou vêm de um endpoint JSON que a página chama, uma requisição HTTP simples é mais rápida e mais leve; como saber que tipo de página você tem em mãos é explicado em [Páginas estáticas e dinâmicas no web scraping](/pt-br/blog/static-vs-dynamic-pages).

## Onde os proxies entram com um navegador headless?

Um proxy dá ao tráfego de um navegador headless um IP de saída em um local escolhido, o que importa quando uma página mostra preços, idiomas ou resultados diferentes conforme o país. Toda biblioteca aceita um servidor proxy nas opções de inicialização ou de contexto, e o navegador passa a enviar por ele todas as requisições da página.

Disso vêm duas consequências. Largura de banda: se você paga por gigabyte, como nos [Proxies residenciais](https://proxynet.io/pt-br/residential-proxy), cada imagem, fonte e script conta, então bloquear os recursos de que você não precisa mantém a conta perto dos dados que você quer. Consistência: uma visita a uma página são muitas requisições, e uma sessão fixa as mantém em um único endereço IP, como aconteceria com um visitante comum.

Quando uma equipe precisa de dados de páginas em grande escala e prefere não manter uma frota de navegadores, a nossa Web Scraping API oferece [extração gerenciada de páginas](/pt-br/data-scraping) por meio da nossa equipe de vendas.

## Por que os sites tratam navegadores automatizados de outra forma?

Os sites podem tratar navegadores automatizados de outra forma porque o tráfego que sobrecarrega um site, ou que viola os termos dele, costuma vir de automação, e um navegador automatizado carrega sinais reconhecíveis. Um site não enxerga intenções; ele enxerga sinais e aplica regras.

Alguns sinais são declarados abertamente. No nosso teste, cada requisição do Chrome headless trazia um cabeçalho User-Agent com `HeadlessChrome/157.0.0.0`, a autodescrição padrão do navegador. O padrão WebDriver do W3C define `navigator.webdriver`, que fica verdadeiro quando um navegador está sob controle remoto, como a forma padrão de avisar a uma página que ela está sendo automatizada. Os sites também pesam a taxa de requisições, os padrões de navegação e a reputação do IP; como essas camadas viram uma única pontuação é explicado em [Como funciona a detecção de bots: a lógica anti-bot](/pt-br/blog/how-bot-detection-works).

O caminho legítimo é trabalhar com essas regras, e não contorná-las. Leia o robots.txt do site, o arquivo que diz quais caminhos os clientes automatizados podem visitar; o [RFC 9309](https://www.rfc-editor.org/rfc/rfc9309.html) o padroniza e observa que as regras dele não são uma forma de autorização de acesso, então leia também os termos do site. Mantenha a taxa de requisições baixa, use uma API oficial onde houver uma e identifique a sua automação quando o site pedir. Este artigo não trata de esconder automação nem de passar por verificações de bots.

## Para que serve um navegador headless?

Navegadores headless são usados sempre que um programa precisa de uma página exatamente como um navegador a montaria.

- **Testes automatizados.** Testes de ponta a ponta percorrem o cadastro ou o checkout na aplicação real a cada mudança de código, em servidores de build sem tela.
- **PDFs e capturas de tela.** Faturas, relatórios e ingressos são desenhados em HTML e impressos em PDF; prévias de links e testes de regressão visual usam capturas de tela.
- **Monitoramento.** Verificações agendadas carregam as páginas principais, medem o tempo delas, confirmam que um botão ou um preço está presente e disparam um alerta quando algo quebra.
- **Agentes de IA.** Agentes que navegam em nome de um usuário controlam um navegador real pelos mesmos protocolos, em headless em um servidor ou com janela quando uma pessoa acompanha.
- **Ler páginas montadas por JavaScript.** Quando o conteúdo só existe depois que os scripts rodam e o site permite acesso automatizado, um navegador headless o renderiza para monitoramento de preços ou pesquisa de mercado.
- **Pré-renderização.** Alguns sites renderizam com antecedência as páginas JavaScript como HTML estático, para que visitantes e crawlers recebam o conteúdo pronto.

## Erros comuns

- **Abrir um navegador para uma página estática.** Se os dados estão no HTML, o curl ou qualquer biblioteca HTTP resolve com uma fração dos recursos.
- **Ler a página cedo demais.** "Carregada" não é "pronta"; espere pelo elemento ou pela resposta de que você precisa em vez de uma pausa fixa.
- **Rodar automação no seu perfil do dia a dia.** Use uma pasta de perfil separada; desde o Chrome 136, a depuração remota recusa a pasta padrão de qualquer forma.
- **Copiar conselhos antigos sobre opções.** Artigos sobre `--headless=new` ou sobre o modo headless antigo descrevem uma divisão que mudou com o Chrome 132.
- **Achar que headless significa invisível para os sites.** O User-Agent padrão e `navigator.webdriver` declaram a automação abertamente.
- **Ignorar o robots.txt e os limites de taxa.** Um navegador carrega muito mais por página do que um cliente HTTP, então um loop descuidado pesa bem mais sobre o site.
- **Deixar processos para trás.** Feche o navegador quando o trabalho terminar, ou o servidor vai se encher de processos órfãos.

## Guia de decisão

| A sua situação | O que usar |
|---|---|
| Os dados estão no HTML da página | Uma requisição HTTP simples |
| A página carrega os dados por uma chamada JSON | Consultar esse endpoint, dentro dos termos do site |
| O conteúdo só aparece depois que os scripts rodam | Um navegador headless |
| Testes de ponta a ponta em um servidor de build | Headless, depurados em modo headful |
| Você precisa de um PDF ou de uma captura de uma página | Opções do Chrome headless ou uma biblioteca |
| Um agente precisa agir em páginas que um usuário acompanha | Um navegador headful com automação |
| O site oferece uma API oficial | A API, e não o navegador |

## Perguntas frequentes

### O que significa navegador headless?

Significa um navegador rodando sem a "cabeça", ou seja, sem a janela visível e a interface. O motor funciona normalmente, mas recebe instruções de código ou de opções de linha de comando e devolve HTML, capturas de tela, PDFs ou dados, em vez de desenhar a página em uma tela.

### Um navegador headless é mais rápido que um navegador comum?

Não muito. Ele deixa de desenhar na tela, mas o trabalho de rede, JavaScript e layout é o mesmo nos dois modos, e qualquer um deles é bem mais lento do que uma requisição HTTP simples para um único arquivo.

### Como rodar o Chrome em modo headless?

Inicie o Chrome com `--headless` mais uma opção de saída como `--dump-dom`, `--screenshot` ou `--print-to-pdf`. Para mais do que uma única captura, use uma biblioteca como Puppeteer, Playwright ou Selenium, que inicia o Chrome em headless e o controla.

### O chrome-headless-shell é a mesma coisa que o modo headless do Chrome?

Não. O `chrome-headless-shell` é a implementação headless antiga e separada, distribuída como programa próprio desde o Chrome 132. O Chrome com `--headless` é o Chrome de verdade sem janelas visíveis, enquanto o shell é um programa à parte que não compartilha o código de navegador do próprio Chrome.

### Agentes de IA usam navegadores headless?

Muitos usam. Um agente que lê páginas web ou age nelas costuma controlar um navegador real via CDP ou WebDriver BiDi, em headless em um servidor e com janela quando uma pessoa acompanha. Agentes que precisam só do texto de páginas simples podem usar requisições HTTP simples.

### Usar um navegador headless é legal?

Rodar um é um uso comum de software; testes, geração de PDFs e monitoramento dos seus próprios sites não levantam questões especiais. Em sites de terceiros, siga os termos e o robots.txt deles, mantenha uma taxa de requisições razoável e respeite as regras de proteção de dados pessoais. Isto é informação geral, não aconselhamento jurídico.

## Em resumo

Um navegador headless é um navegador completo sem a janela: ele carrega a página, executa JavaScript e renderiza o resultado, depois entrega HTML, uma captura de tela, um PDF ou dados ao seu programa. O modo headless do Chrome agora é o Chrome de verdade, com a implementação antiga mantida como `chrome-headless-shell`, e as bibliotecas o controlam via CDP, WebDriver ou WebDriver BiDi. Use um só quando a página precisar de um navegador, espere pelo conteúdo e não pelo evento de carregamento, mantenha taxas de requisição educadas e passe o tráfego por um proxy no país certo quando a página mudar conforme a localização.
