Desarrolla tus comandos del Protocolo de herramientas para desarrolladores de Chrome (CDP) de forma eficiente con el nuevo editor de comandos

El protocolo de Chrome DevTools (CDP) es un protocolo de depuración remota (API) que permite que los desarrolladores se comuniquen con un navegador Chrome en ejecución. Las herramientas para desarrolladores de Chrome usan CDP para ayudarte a inspeccionar el estado del navegador, controlar su comportamiento y recopilar información de depuración. También puedes compilar extensiones de Chrome que usen CDP.

Por ejemplo, este es un comando de CDP que inserta una regla nueva con el ruleText determinado en una hoja de estilo con styleSheetId determinado, en la posición especificada por location.

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

La pestaña del panel lateral Protocol Monitor te brinda una forma de enviar solicitudes de CDP y ver todas las solicitudes y respuestas de CDP que envía y recibe DevTools.

La barra de línea de comandos en la parte inferior del Monitor de protocolos

Anteriormente, era difícil crear el comando de forma manual, en especial, un comando con muchos parámetros. No solo debías tener en cuenta los corchetes y las comillas de apertura y cierre, sino que también debías recordar los parámetros del comando, lo que, a su vez, te lleva a buscar la documentación de CDP.

Para resolver este problema, DevTools presentó un nuevo editor de CDP cuyos objetivos principales son los siguientes:

  • Comandos de autocompletado: Simplifica la entrada de comandos de CDP proporcionándote la lista de comandos disponibles a través de una función de autocompletar.
  • Propaga automáticamente los parámetros del comando. Reduce la necesidad de consultar la documentación de CDP para obtener la lista de parámetros de comandos disponibles.
  • Simplifica la escritura del parámetro. Solo debes completar los valores de los parámetros que deseas enviar.
  • Editar y reenviar. Mejora la velocidad de prototipado, ya que permite modificar un comando de CDP más rápido.

Ahora, veamos qué ofrece este nuevo editor y cómo puedes usarlo.

Función de autocompletado

El menú desplegable de autocompletar.

La barra de entrada de comandos ahora cuenta con una función de autocompletado. Te ayuda a escribir los nombres de los comandos de CDP a los que tienes acceso. Esto puede ser muy útil para los comandos que no aceptan parámetros.

Parámetros de cadena y número

Con este nuevo editor, ahora puedes editar fácilmente los valores de los parámetros primitivos. Para abrir el editor, haz clic en el ícono Abre el panel izquierdo. junto a la entrada de comandos.

Una vez que ingreses el nombre del comando, el editor te mostrará los parámetros correspondientes automáticamente. No tienes que buscar documentación para saber qué parámetros van con qué comandos. Además, el editor muestra los parámetros en un orden determinado: primero los obligatorios (en rojo) y, luego, los opcionales (en azul).

Para agregar un valor a un parámetro opcional, coloca el cursor sobre su nombre y haz clic en el botón +. Para restablecer el parámetro a indefinido, haz clic en el botón Restablecer al valor predeterminado.

Los botones + y "Restablecer al valor predeterminado".

Parámetros enumerados y booleanos

Cuando edites parámetros enum o booleanos, verás un menú desplegable que proporciona una selección de valores potenciales (para enums) o la opción directa de verdadero o falso para los booleanos. Esta función reduce la posibilidad de escribir un valor incorrecto para los parámetros de enumeración y mantiene la precisión y la simplicidad.

Los menús desplegables booleano y enum

Parámetros de array

En el caso de los parámetros de array, puedes agregar valores al array de forma manual. Coloca el cursor sobre la fila del parámetro y haz clic en el botón +.

El botón + que agrega un elemento de array.

Para borrar los elementos del array uno por uno, haz clic en el botón de la papelera junto a los elementos. También puedes borrar todos los parámetros del array con el botón de bloqueo. En este caso, el parámetro del array se restablece a [].

Los botones "Borrar parámetro" y "Restablecer a la configuración predeterminada".

Parámetros de objetos

Cuando ingresas un comando que acepta parámetros de objetos, el editor muestra una lista de las claves de este objeto y puedes editar sus valores directamente. Esto funciona para todos los tipos de parámetros anidados.

Parámetros anidados.

Descubre qué hacen el comando y los parámetros en el editor

¿Alguna vez te preguntaste cuál es el propósito de un parámetro o comando? Ahora, puedes colocar el cursor sobre un comando o parámetro para que aparezca una herramienta de ayuda descriptiva con un vínculo a la documentación en línea.

Es la información descriptiva que aparece cuando colocas el cursor sobre un comando.

Recibirás una advertencia antes de enviar parámetros incorrectos

Anteriormente, si no sabías si el valor de un parámetro era del tipo correcto y tenías que esperar para leer la respuesta de error, este nuevo editor es para ti. Te muestra errores en tiempo real si el parámetro no puede aceptar el valor que ingresaste.

Un ícono de error junto a un parámetro con un valor incorrecto

Cómo volver a enviar un comando

Si necesitas modificar un parámetro del comando que acabas de enviar, no es necesario que lo vuelvas a escribir. Para editar y volver a enviar el comando, haz clic con el botón derecho en un elemento de la cuadrícula de datos y selecciona Editar y volver a enviar en el menú desplegable. Se volverá a abrir automáticamente el editor de CDP y se completará previamente con el comando que seleccionaste.

Menú desplegable de un comando en la cuadrícula de datos con la opción "Editar y volver a enviar".

Cómo copiar un comando en formato JSON

Para copiar el comando CDP en formato JSON en el portapapeles, haz clic en el ícono de copia Copiar. que se encuentra en el extremo izquierdo de la barra de herramientas. Además, ten en cuenta que, si ingresas un comando directamente en la barra de entrada, se propagará sin problemas en el editor y viceversa.

Conclusión

El objetivo del equipo de DevTools con el diseño de este nuevo editor de CDP era simplificar la escritura de los comandos de CDP. El nuevo editor también se puede usar para ver los parámetros junto con la documentación y para proporcionarte una forma más fácil de enviar tus comandos de CDP.

Descarga los canales de vista previa

Considera usar Chrome Canary, Dev o Beta como tu navegador de desarrollo predeterminado. Estos canales de versión preliminar te brindan acceso a las funciones más recientes de DevTools, te permiten probar las APIs de plataformas web de vanguardia y te ayudan a encontrar problemas en tu sitio antes que tus usuarios.

Comunícate con el equipo de Chrome DevTools

Usa las siguientes opciones para hablar sobre las funciones nuevas, las actualizaciones o cualquier otro tema relacionado con DevTools.