Crie seus comandos do Chrome Devtools Protocol (CDP) de maneira eficiente com o novo editor de comandos

O protocolo Chrome DevTools (CDP) é um protocolo de depuração remota (API) que permite que os desenvolvedores se comuniquem com um navegador Chrome em execução. O Chrome DevTools usa o CDP para ajudar a inspecionar o estado do navegador, controlar o comportamento dele e coletar informações de depuração. Você também pode criar extensões do Chrome que usam o CDP.

Por exemplo, este é um comando CDP que insere uma nova regra com o ruleText fornecido em uma folha de estilo com o styleSheetId fornecido, na posição especificada por location.

{ 
    command: 'CSS.addRule', 
    parameters: {
        styleSheetId: '2',
        ruleText:'Example', 
        location: {
            startLine: 1,
            startColumn: 1,
            endLine: 1,
            endColumn: 1
        }
    }
}

A guia da gaveta Protocol monitor oferece uma maneira de enviar solicitações do CDP e conferir todas as solicitações e respostas do CDP enviadas e recebidas pelo DevTools.

A barra de linha de comando na parte de baixo do Monitor de protocolo.

Antes, era difícil criar o comando manualmente, especialmente um comando com muitos parâmetros. Além de prestar atenção aos colchetes e aspas, você também precisa se lembrar dos parâmetros do comando, o que exige que você consulte a documentação do CDP.

Para resolver esse problema, as Ferramentas do desenvolvedor introduziram um novo editor de CDP com os seguintes objetivos principais:

  • Comandos de preenchimento automático. Simplifique a entrada de comando do CDP fornecendo a lista de comandos disponíveis por um recurso de preenchimento automático.
  • Preencha automaticamente os parâmetros do comando. Reduza a necessidade de consultar a documentação do CDP para conferir a lista de parâmetros de comando disponíveis.
  • Simplifique a digitação de parâmetros. Basta preencher os valores dos parâmetros que você quer enviar.
  • Editar e reenviar. Melhore a velocidade da prototipagem, tornando mais rápido modificar um comando do CDP.

Agora, vamos conferir o que esse novo editor oferece e como você pode usá-lo.

Recurso de preenchimento automático

O menu suspenso de preenchimento automático.

Um recurso de preenchimento automático agora alimenta a barra de entrada de comando. Ele ajuda a escrever os nomes dos comandos do CDP aos quais você tem acesso. Isso pode ser muito útil para comandos que não aceitam parâmetros.

Parâmetros de string e número

Com esse novo editor, agora é possível editar facilmente os valores de parâmetros primitivos. Para abrir o editor, clique no ícone Abra o painel à esquerda. ao lado da entrada de comando.

Depois que você insere o nome do comando, o editor mostra os parâmetros correspondentes automaticamente. Você não precisa consultar a documentação para saber quais parâmetros são usados com quais comandos. Além disso, o editor mostra os parâmetros em uma determinada ordem: primeiro os obrigatórios (em vermelho) e depois os opcionais (em azul).

Para adicionar um valor a um parâmetro opcional, passe o cursor sobre o nome dele e clique no botão +. Para redefinir o parâmetro como indefinido, clique no botão Redefinir para o valor padrão.

Os botões "+" e "Redefinir para o valor padrão".

Parâmetros de tipo enumerado e booleano

Ao editar parâmetros de tipo enumerado ou booleano, você vai encontrar um menu suspenso que oferece uma seleção de valores em potencial (para tipos enumerados) ou a opção simples "verdadeiro" ou "falso" para booleanos. Esse recurso reduz a possibilidade de digitar o valor errado para parâmetros de enumeração e mantém a precisão e a simplicidade.

Os menus suspensos booleano e tipo enumerado.

Parâmetros de matriz

Para parâmetros de matriz, é possível adicionar valores manualmente à matriz. Passe o cursor sobre a linha do parâmetro e clique no botão +.

O botão "+" que adiciona um item de matriz.

Para excluir os itens da matriz um por um, clique no botão da lixeira ao lado deles. Também é possível limpar todos os parâmetros da matriz com o botão de bloqueio. Nesse caso, o parâmetro de matriz é redefinido como [].

Os botões "Excluir parâmetro" e "Redefinir para o padrão".

Parâmetros de objeto

Quando você insere um comando que aceita parâmetros de objeto, o editor lista as chaves desse objeto, e você pode editar os valores diretamente. Isso funciona para todos os tipos de parâmetros aninhados.

Parâmetros aninhados.

Descubra o que o comando e os parâmetros fazem no editor

Você já teve dúvidas sobre a finalidade de um parâmetro ou comando? Agora, você pode passar o cursor sobre um comando ou parâmetro, e uma dica descritiva vai aparecer, com um link para a documentação on-line.

A dica descritiva que aparece quando você passa o cursor sobre um comando.

Receber um aviso antes de enviar parâmetros incorretos

Antes, se você não soubesse se o valor de um parâmetro era do tipo correto e precisasse esperar para ler a resposta de erro, esse novo editor é para você. Ele mostra erros em tempo real se o parâmetro não aceitar o valor inserido.

Um ícone de erro ao lado de um parâmetro com um valor incorreto.

Reenviar um comando

Se você precisar ajustar um parâmetro do comando que acabou de enviar, não será necessário digitá-lo novamente. Para editar e reenviar o comando, clique com o botão direito do mouse em um item na grade de dados e selecione Edit and resend no menu suspenso. Isso vai reabrir o editor do CDP automaticamente e preenchê-lo com o comando selecionado.

O menu suspenso de um comando na grade de dados com a opção "Edit and resend".

Copiar um comando para o formato JSON

Para copiar o comando CDP no formato JSON para a área de transferência, clique no ícone de cópia Copiar. no final esquerdo da barra de ferramentas. Além disso, se você inserir um comando diretamente na barra de entrada, ele será preenchido no editor e vice-versa.

Conclusão

O objetivo da equipe de DevTools ao criar esse novo editor de CDP era simplificar a digitação de comandos. O novo editor também pode ser usado para conferir parâmetros com a documentação e facilitar o envio de comandos do CDP.

Fazer o download dos canais de visualização

Use o Chrome Canary, Dev ou Beta como navegador de desenvolvimento padrão. Esses canais de visualização dão acesso aos recursos mais recentes do DevTools, permitem testar APIs de plataforma da Web de última geração e ajudam a encontrar problemas no seu site antes que os usuários.

Entre em contato com a equipe do Chrome DevTools

Use as opções a seguir para discutir os novos recursos, atualizações ou qualquer outra coisa relacionada ao DevTools.