Interceptação HTTP

O Guida pode interceptar solicitações HTTP antes que saiam do navegador, permitindo inspecionar cabeçalhos e corpos, modificar solicitações em tempo real, simular respostas ou reenviar solicitações capturadas com alterações. Ele usa o domínio CDP Fetch embutido no navegador; não exige configuração de proxy nem certificados SSL.

Painel Intercept

Clique em Enable Intercept para começar a pausar todas as solicitações de saída. Cada solicitação fica retida em uma lista até você decidir o que fazer.

Painel Intercept mostrando solicitações pausadas com painel de detalhes, ações forward/drop/mock e guia rules

O painel Intercept pausa solicitações correspondentes do navegador para que você inspecione cabeçalhos e corpos antes de encaminhar, descartar ou simular respostas.

Ações

Ação	Atalho	O que faz
Forward	F	Continua a solicitação para o servidor
Drop	D	Aborta a solicitação
Mock	—	Retorna uma resposta personalizada sem contatar o servidor
Forward + Intercept ↩	—	Encaminha a solicitação e pausa a resposta quando ela chega
Forward All	—	Continua todas as solicitações pausadas de uma vez
Drop All	—	Aborta todas as solicitações pausadas

Selecione uma solicitação pausada para inspecionar seus cabeçalhos e corpo no painel de detalhes. O corpo é editável para solicitações POST/PUT.

Interceptação de resposta

Para inspecionar um corpo de resposta, como um arquivo JS, resposta JSON de API ou página HTML, clique em Forward + Intercept ↩ em vez de Forward. A solicitação é enviada ao servidor e o item da lista muda no mesmo lugar para mostrar status, cabeçalhos e corpo decodificado da resposta. Depois você pode encaminhar a resposta ao navegador, descartá-la ou substituí-la por um mock.

Regras

Abra a guia Rules para adicionar regras persistentes de interceptação. Cada regra tem um padrão glob de URL, um filtro opcional de método HTTP e uma ação:

Ação	Comportamento
Pause	Reter solicitações correspondentes para revisão manual, como o padrão
Continue	Deixar solicitações correspondentes passarem sem pausa
Block	Abortar solicitações correspondentes com erro de rede
Mock	Retornar uma resposta personalizada para solicitações correspondentes

Regras têm prioridade sobre o comportamento padrão de pausar tudo. Por exemplo, adicionar uma regra Continue para *.css deixa folhas de estilo carregarem normalmente enquanto todo o restante é pausado.

HTTP Client

O painel HTTP Client permite reenviar e modificar solicitações capturadas, como uma alternativa integrada a Postman ou Insomnia.

Painel HTTP Client mostrando editor de solicitação com método, URL, grade de cabeçalhos e visualizador de resposta

O HTTP Client reenvia solicitações capturadas com método, URL, cabeçalhos, corpo e histórico de respostas editáveis.

Enviar uma solicitação

Abra o painel History e mude para a guia Network
Clique com o botão direito em qualquer solicitação e escolha Send to HTTP Client
O painel abre com método, URL, cabeçalhos e corpo já preenchidos

Edite qualquer coisa, como método, cabeçalho ou corpo, e clique em Send. A resposta aparece no painel inferior com código de status, tempo de resposta, cabeçalhos e corpo. JSON é formatado automaticamente.

Histórico de solicitações

O menu suspenso no canto inferior direito guarda todos os envios anteriores. Selecione uma entrada para restaurar os parâmetros da solicitação e sua resposta, facilitando a comparação entre tentativas.

API de scripts

O namespace g.intercept.* permite que scripts controlem a interceptação por código:

// Bloquear solicitações de anúncios/rastreamento durante a navegação
g.intercept.enable();
g.intercept.addRule("https://ads.example.com/*", { action: "block" });
g.intercept.addRule("https://tracking.example.com/*", { action: "block" });

await g.nav.navigateToUrl("https://example.com");

// Limpar ao terminar
g.intercept.clearRules();
g.intercept.disable();

Método	Descrição
`g.intercept.enable()`	Ativa interceptação de solicitações
`g.intercept.disable()`	Desativa interceptação e libera todas as solicitações pausadas
`g.intercept.isEnabled()`	Verifica se a interceptação está ativa
`g.intercept.addRule(pattern, options?)`	Adiciona uma regra e retorna o ID
`g.intercept.removeRule(ruleId)`	Remove uma regra específica
`g.intercept.clearRules()`	Remove todas as regras
`g.intercept.listRules()`	Lista regras ativas

Regras com ação de script

Regras com action: "script" executam um arquivo JavaScript para cada solicitação correspondente. O script recebe a solicitação por g.intercept.getRequest() e decide o que fazer:

// intercept-handler.js — roda por solicitação
const req = g.intercept.getRequest();

// Adicionar cabeçalho personalizado e continuar
g.intercept.continue({
  headers: { "X-Custom-Auth": "my-token" }
});

Método	Descrição
`g.intercept.getRequest()`	Obtém a solicitação pausada (URL, método, cabeçalhos, corpo)
`g.intercept.continue(options?)`	Encaminha com cabeçalhos/URL opcionais modificados
`g.intercept.respond(status, headers?, body?)`	Retorna uma resposta mock
`g.intercept.abort(reason?)`	Aborta a solicitação

Próximos passos

Capturar tráfego de rede — registre e inspecione solicitações a partir de um script
Integração MCP — exponha automação de navegador a clientes de IA externos
Ferramentas personalizadas — ferramentas MCP com escopo de espaço de trabalho e baseadas em scripts
Credenciais — armazenamento criptografado de credenciais para autenticação de APIs
Referência da API — documentação completa da API de scripts