O que o protocolo permite inspecionar
O Chrome DevTools Protocol (CDP) permite que uma ferramenta examine e controle componentes do Chrome e de outros navegadores baseados no Blink. A comunicação usa mensagens JSON enviadas a um alvo de depuração, como uma página ou um worker, que executa trabalho em segundo plano.
Cada domínio reúne funções relacionadas. O domínio Network acompanha a rede e o domínio DOM permite examinar a estrutura do documento da página. O cliente envia comandos e recebe respostas, além de eventos que o navegador emite durante a execução. Esses eventos permitem acompanhar uma requisição sem consultar repetidamente se algo mudou.
Uma requisição vista pelo domínio Network
Um cliente já conectado a uma página pode enviar a mensagem abaixo para habilitar os eventos de rede. O campo id identifica o comando e method informa a função chamada:
{"id": 1, "method": "Network.enable"}Depois da habilitação, o evento Network.requestWillBeSent informa que a página está prestes a enviar uma requisição. Ele inclui o endereço solicitado e um identificador da requisição. Você pode acompanhar os eventos seguintes para investigar a resposta ou uma falha. A emissão desse primeiro evento, por si só, não comprova que o servidor recebeu a chamada nem que ela terminou com sucesso.
A referência de Network detalha os campos dessas mensagens. Para automatizar o Chrome, a documentação do protocolo orienta utilizar produtos com suporte, como o Puppeteer ou o ChromeDriver. O uso direto por terceiros não tem suporte nem garantia de compatibilidade entre versões.
Dúvidas frequentes
Perguntas frequentes sobre Chrome DevTools Protocol
- Qual é a diferença entre um alvo e um domínio do protocolo?
- O alvo é o componente conectado, como uma página ou um worker. Um domínio agrupa funções do protocolo, como Network para acompanhar a rede. Uma conexão com uma página pode utilizar vários domínios.
- O uso direto do protocolo tem compatibilidade garantida?
- A documentação do Chrome não garante compatibilidade retroativa para clientes diretos. A versão mais recente acompanha mudanças do Chromium e pode exigir ajustes no cliente.
- É seguro compartilhar o endereço de depuração?
- Esse endereço dá acesso a capacidades amplas de inspeção e controle. O protocolo pressupõe clientes confiáveis, portanto o acesso deve ficar restrito às ferramentas autorizadas.
Para continuar
Recursos relacionados
Documentação
Chrome: comandos e eventos de inspeção
Referência dos domínios e das mensagens, com as condições de suporte e compatibilidade do protocolo.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para investigar falhas de uma página e conferir o comportamento do navegador durante o desenvolvimento.
Abrir recursoDocumentação
Chrome DevTools: domínio Network
Comandos e eventos para acompanhar as requisições feitas por uma página.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A inspeção do navegador permite conferir as requisições e o comportamento das páginas durante o desenvolvimento com agentes.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.