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 protocolo Chrome DevTools (CDP, na sigla em inglês) para instrumentar, inspecionar, depurar e criar o perfil dos 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 de CDP
  • Inspecionar mensagens do CDP
  • Salvar mensagens do CDP
  • Enviar comandos do CDP

Abrir o monitor de protocolo

Para abrir o Monitor de protocolo, siga estas etapas:

  1. Verifique se o experimento está ativado. Marque a caixa de seleção Monitor de protocolo em Configuraçõesconfigurações > Experimentos.

  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 Show Protocol monitor e pressione Enter. O DevTools exibe o painel Monitor de protocolo na parte inferior da janela.

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

Gravar solicitações e respostas de CDP

Ao abrir o Monitor de protocolo, ele começa a gravar automaticamente as mensagens do CDP na página atual. O monitor de protocolo continuará a gravar mesmo se você atualizar a página ou fechar o Devtools.

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

O botão "Gravar" no painel do monitor de protocolo.

Inspecionar mensagens do CDP

Conforme 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 de 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 do monitor de protocolo.

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

Clique com o botão direito do mouse em um valor na coluna Method para ver as opções baseadas em contexto.

Limpar e fazer download de mensagens do CDP

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

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

Enviar comandos brutos do CDP

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

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

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

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

Menu suspenso "Destino" destacado no monitor de protocolo.

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

    1. Clique no botão left_panel_open Mostrar editor de comando do CDP ao lado do campo de entrada de comando para abrir o editor de comandos.
    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 protocolos.
    3. Depois que você inserir um comando do CDP, o editor vai criar um formulário estruturado de parâmetros com base nas definições do protocolo. Preencha estes parâmetros para enviá-los com seu comando. Entrada de parâmetro com parâmetros relacionados ao service worker listados para preenchimento.
    4. Envie o comando clicando no botão Enviar Enviar comando ou pressionando Ctrl + Enter.

Você também pode editar e reenviar comandos da tabela. Clique com o botão direito do mouse em um item da tabela e selecione Editar e reenviar no menu suspenso. Isso abrirá automaticamente o editor de CDP e o preencherá com o comando selecionado.

Para saber mais sobre o editor de CDP, consulte Criar comandos do CDP do Chrome Devtools Protocol (CDP) de forma eficiente com o novo editor de comando.