Monitor de protocolo: visualizar e enviar solicitações de CDP

Dale St. Marthe
Dale St. Marthe

Use o Monitor de protocolo para conferir todas as solicitações e respostas do CDP feitas pelo DevTools e enviar comandos do CDP diretamente.

Visão geral

O Chrome DevTools usa o Chrome DevTools Protocol (CDP) para instrumentar, inspecionar, depurar e criar perfis de navegadores Chrome. Os desenvolvedores podem usar o Monitor de protocolo para trabalhar com o CDP de maneira programática.

O Monitor de protocolo permite fazer o seguinte:

  • Gravar solicitações e respostas do CDP
  • Inspecionar mensagens do CDP
  • Salvar mensagens do CDP
  • Enviar comandos do CDP

Abrir o monitor de protocolo

Para abrir o Protocol monitor, siga estas etapas:

  1. Verifique se o experimento está ativado. Marque a caixa de seleção Protocol Monitor em Settings > Experiments.

  2. Abra o menu de comando pressionando:

    • macOS: Command+Shift+P
    • Windows, Linux e ChromeOS: Control+Shift+P Menu de comando com
  3. Comece a digitar Protocol monitor, selecione Mostrar monitor de protocolo e pressione Enter. As Ferramentas do desenvolvedor mostram o painel Protocol monitor na parte de baixo da janela.

Como alternativa, no canto superior direito, selecione Mais opções > Mais ferramentas > Monitor de protocolo.

Gravar solicitações e respostas do CDP

Quando você abre o Monitoramento de protocolo, ele começa a gravar automaticamente as mensagens do CDP da página atual. O Monitor de protocolo continua gravando mesmo que você atualize a página ou feche o DevTools.

Para interromper ou iniciar a gravação, clique no botão de gravação à esquerda da barra de ações na parte de cima do painel.

O botão de gravação no painel "Monitor de protocolo".

Inspecionar mensagens do CDP

À medida que o Monitor de protocolo registra, as mensagens do CDP são registradas em uma tabela no lado esquerdo do painel.

Clique em uma célula Método, Solicitação ou Resposta para abrir uma visualização detalhada dos dados de Solicitação ou Resposta no lado direito do painel.

Um método destacado no painel "Monitor de protocolo".

Alterne entre os dados de Solicitação ou Resposta clicando na respectiva guia de cabeçalho.

Clique com o botão direito do mouse em um valor na coluna Método para acessar opções com base no contexto.

Limpar e fazer o download de mensagens do CDP

Para limpar todas as mensagens gravadas do CDP, clique no botão de limpeza na barra de ações.

Para fazer o download das mensagens gravadas como um arquivo JSON, clique em .

Enviar comandos brutos do CDP

Há duas maneiras principais de enviar um comando CDP pelo Protocolo monitor:

  • Se o comando não exigir parâmetros, digite-o no campo de entrada na parte de baixo do Protocol Monitor e pressione Enter. Por exemplo, Page.captureScreenshot.

    Se o comando exigir parâmetros, forneça-os no formato JSON, por exemplo, {"cmd":"Page.captureScreenshot","args":{"format": "jpeg"}}.

    O menu suspenso à direita do campo de entrada especifica o destino.

Menu suspenso de destino destacado no monitor de protocolo.

  • Também é possível usar o editor do CDP para editar e emitir comandos:

    1. Abra o editor de comando clicando no botão Show CDP command editor ao lado do campo de entrada de comando.
    2. Selecione um destino na lista suspensa e comece a digitar um comando do CDP ao lado do prompt de comando. O preenchimento automático oferece opções relevantes. Selecione o comando que você quer usar. A entrada de comando no monitor de protocolo.
    3. Depois de inserir um comando CDP, o editor cria uma forma estruturada de parâmetros com base nas definições de protocolo. Preencha esses parâmetros para enviá-los com o comando. Entrada de parâmetro com parâmetros relacionados ao service worker listados para preenchimento.
    4. Para enviar o comando, clique no botão Send command ou pressione Ctrl + Enter.

Você também pode editar e reenviar comandos na tabela. Clique com o botão direito do mouse em um item na tabela e selecione "Editar e reenviar" no menu suspenso. Isso vai reabrir o editor do CDP automaticamente e preenchê-lo com o comando selecionado.

Para mais informações sobre o editor CDP, consulte Criar comandos do protocolo de ferramentas para desenvolvedores do Chrome (CDP) de maneira eficiente com o novo editor de comandos.