Pruebas de ciclo completo con Cypress

Hola a todos, estoy encantado de estar aquí. Mi nombre es Filip y soy un probador con quizás algunas habilidades de desarrollador o un desarrollador con habilidades de testing. No lo sé. Depende de cómo lo mires. También soy un embajador de Cypress, lo que significa que me gusta hablar sobre Cypress y me encanta enseñar a la gente cómo usar esta increíble herramienta. Así que eso es lo que estaré haciendo hoy.

El tema de la charla de hoy es la prueba de ciclo completo con Cypress. Entonces, ¿qué significa eso?. Bueno, es un término completamente inventado. Lo inventé para hacer esta charla un poco interesante y espero que le eches un vistazo. Pero tengo una idea detrás de eso que me gustaría compartir contigo. Así que déjame dibujar un círculo o un anillo. Pero no te preocupes, no vas a morir cuando lo mires, espero. Pero espero que aprendas algo nuevo. Y sí, vamos a echarle un vistazo.

Como sabes, existe algo que se llama pirámide de testing, que no voy a dibujar aquí porque todos saben lo que es. También contiene algo que podría estar en la cima de la pirámide, y eso es algo con lo que voy a empezar la charla de hoy. Y eso son las pruebas de extremo a extremo. Entonces, cuando hablamos de Cypress, esto es donde Cypress brilla más y esto es lo que Cypress es más conocido. Así que si nunca has usado Cypress, te recomiendo que revises la masterclass. Tengo un enlace en la parte inferior de esta diapositiva. Pero también va a haber una masterclass en la cumbre de test.js en solo un par de días. Así que asegúrate de revisarlo si aún puedes, espero que puedas. Y podemos encontrarnos allí y puedes aprender a trabajar con Cypress conmigo. Así que si puedes hacerlo a esa, asegúrate de revisar mi sitio web, y encontrarás uno a finales de noviembre.

Entonces, echemos un vistazo a Cypress y cómo puedes escribir realmente una prueba con Cypress. Así que en el lado derecho tengo mi Cypress funcionando en modo de user interface gráfica, así que sería el que ejecutas con npx-cypress-open en tu terminal. Y a la izquierda, tengo una prueba que te mostraré más tarde. Quiero mostrarte esta ahora mismo, la prueba de extremo a extremo. Entonces, dentro de esta prueba, estoy haciendo un flujo simple.

Estoy visitando una aplicación, y luego estoy seleccionando un elemento, escribiendo en él, presionando enter, y luego realizando algunas acciones de nuevo. Obteniendo un elemento, haciendo clic, escribiendo, interactuando con mi página. Básicamente, lo que quiero hacer es ir a mi página de inicio, crear un nuevo tablero, luego crear una nueva lista, y dentro de ella, crear una nueva tarjeta. Y esto es lo que el flujo automatiza.

Entonces, cada vez que cometo un error, por ejemplo, cambio mi selector para no ser encontrado, y cuando guardo mi prueba, se volverá a ejecutar automáticamente. Si cometo un error durante mi prueba, obtengo este agradable error de afirmación que me explica lo que realmente sucedió. Entonces, en este caso, lo que realmente sucedió es que no pudo encontrar el selector porque cometí un error tipográfico en él y no se encontraba en ninguna parte. Cypress en realidad va a intentar buscar ese selector durante 4,000 milisegundos, así que durante cuatro segundos.

Ahora, esto significa que Cypress funciona realmente bien para las aplicaciones que todo el tiempo están volviendo a renderizar y haciendo algún tipo de búsqueda desde la API, etc. como lo hacen las aplicaciones modernas. Entonces, cuando estás testing, obtienes esta retroalimentación instantánea sobre lo que ha hecho tu prueba. Pero también, lo importante aquí es que estamos ejecutando dentro del navegador. Entonces, mientras estamos haciendo eso, obtenemos todas las ventajas que el navegador nos proporcionará. Entonces, por ejemplo, podemos abrir una console y echar un vistazo a lo que está sucediendo dentro de la console. Entonces, estoy obteniendo un par de advertencias aquí, pero estas no son tan importantes. Cypress en realidad aprovecha muy bien la console y el hecho de que estamos ejecutando dentro del navegador. Entonces, cuando hago clic en cualquiera de mis comandos, por ejemplo este comando de visita, Cypress imprimirá información en la console con los detalles de ese comando. También imprimirá información para cada solicitud HTTP que se esté haciendo con la aplicación. Entonces, tal vez arreglemos la prueba, guárdela para que pase. Y también, lo que Cypress nos permite, como puedes ver, es retroceder en el tiempo y examinar la aplicación tal como se veía mientras se estaba ejecutando la prueba. Entonces, esto es bastante ordenado, esto te da una idea, especialmente si estás buscando un selector que es un poco difícil de encontrar porque el elemento aparece y luego desaparece. Esta es una herramienta realmente, realmente útil. Entonces, puedes ver diferentes llamadas a la API, y Cypress te invita a entrar en la aplicación y examinar la aplicación y conocer sus entresijos. Entonces, un gran área para comenzar a examinar tu aplicación un poco más es hacer pruebas de API, y esta es en realidad la segunda parte de nuestro círculo de pruebas.

Entonces, cuando estamos haciendo pruebas de API en Cypress, podemos usar un comando llamado request, así que déjame mostrarte ese. Y cambiémoslo porque te voy a mostrar el comando de API en solo un segundo. Entonces, déjame guardar mi prueba y déjame abrir eso en mi corredor de Cypress. Oops, lo siento, esa no era la prueba correcta. Queremos ejecutar la prueba de API. Entonces, ahora lo tenemos.

Así que aquí dentro, lo que estoy haciendo es usar el comando request para enviar una solicitud POST a la URL de los tableros de API. Como puedes ver, la sintaxis de mi prueba es bastante simple. Estoy utilizando el objeto global CY que está disponible en todo el conjunto de pruebas y estoy utilizando el comando request que está ahí para enviar solicitudes de API. Así que, por supuesto, lo que estoy haciendo es enviar la API POST y aquí está el cuerpo que estoy enviando hacia el servidor.

Ahora, cuando recibo una respuesta, tomo con el comando its y tomo el estado y me aseguro de que es 201. ¿Cómo sé que debo buscar el estado y el contenido de la respuesta? Bueno, la primera forma de cómo puedo mirar eso es hacer clic en mi comando y, tal como te mostré hace unos segundos, abrir la console y examinar lo que el comando ha producido. Así que con mi comando its, he sacado el estado y luego comprobado si el número de ese estado es 201, así que lo es y mi prueba está pasando.

Así que esto es realmente genial, ¿verdad? Pero veo un pequeño problema aquí. Quizás tú también lo ves. Tenemos ese gran espacio blanco aquí que no se utiliza para nada. Así que eso no es tan bueno, ¿verdad? Así que lo que hice con eso es que me inspiré en la comunidad de código abierto community, y en concreto en Clep Bakhmuto, que ha construido un plugin para mostrar la API en el navegador. Y he hecho una especie de mi propia versión de eso. Así que tengo esto instalado en mi repositorio y lo que este plugin hará es que añadirá un nuevo comando a la biblioteca de Cypress. Se llama API y funciona exactamente igual que CY-request. Así que cuando guardo mi prueba, imprimirá la información sobre la solicitud en el navegador. Así que puedo ver el método, puedo ver la URL, también el estado y también veo el cuerpo de la solicitud y el cuerpo de la respuesta y toda esa información. Incluso puedo copiar el contenido del cuerpo de la respuesta al portapapeles y quizás puedo simplemente intentar, intentar escribir una prueba, así que vamos con su cuerpo y hagamos un igual profundo y pegaré mi objeto aquí. Creo que eso debería funcionar. Déjame guardar eso y sí. Estamos bien. Así que estamos testing la API con nuestro comando de disparo y con la retroalimentación visual que obtuvimos aquí. Así que como dije, Cypress es conocido por las pruebas de extremo a extremo y como puedes ver, es una gran herramienta incluso para las pruebas de API. Así que lo que podemos hacer es combinar estos dos mundos. Podemos hacer pruebas de extremo a extremo y pruebas de API. Y como todas las solicitudes que Cypress envía son enviadas desde Node, no son enviadas desde el navegador, lo que podemos hacer es llamar a cualquier API que queramos. Así que en realidad tengo una prueba aquí, déjame mostrarte esa, donde estoy testing un correo electrónico. Así que déjame abrir esa y explicar lo que está pasando aquí. Así que voy a través de la línea de tiempo para poder viajar atrás en el tiempo y guiarte a través de lo que está sucediendo. Así que estoy visitando una página de registro y luego estoy llenando el correo electrónico y la contraseña y estoy marcando esta bonita casilla. Así que déjame mostrarte eso.

Y esto dice envíame un correo electrónico de bienvenida. Así que lo que esta aplicación hará es que realmente te enviará un correo electrónico si marcas esa casilla de verificación. Y lo que puedo hacer, puedo realmente probar si la aplicación está haciendo lo que debería estar y si está enviando los datos adecuados al servidor, lo cual es genial porque ahora para las pruebas de API, no estoy utilizando las solicitudes directas que sé cómo preparar, sino que estoy realmente probando si la aplicación está enviando los datos adecuados al servidor y comprobando si no está enviando algunos datos corruptos o no maneja correctamente las entradas como lo hace aquí.

Así que lo que Cypress y el comando intercept me permiten también es comprobar diferentes casos límite. No sólo puedo observar que una solicitud de API sucede, también puedo de alguna manera cortar la respuesta del servidor y proporcionar la mía propia. Así que lo que puedo hacer, puedo cambiar el cuerpo, puedo cambiar el estado de la respuesta. Incluso puedo cambiar el tiempo de respuesta, que es exactamente lo que estoy haciendo aquí. Así que tengo un callback y estoy manejando la respuesta para que se retrase unos 10 segundos. Así que cuando ahora guardo mi prueba, puedes ver que la solicitud de API boards está realmente tomando y tengo este botón de recarga que se muestra en la aplicación, que normalmente sería un lugar realmente difícil de alcanzar y de probar. Pero con Intercept, podemos realmente mostrar eso y ver si se comporta correctamente, si aparece después de tres segundos, como debería, y si funciona correctamente. Así que podemos hacer clic en él y asegurarnos de que nuestra aplicación se recargará.

Así que con las pruebas de la capa de red, podemos llegar a diferentes casos difíciles de alcanzar. Y uno de los grandes ejemplos de cómo podemos llegar a diferentes casos límite es probando la capa de aplicación. Así que eso es lo que Cypress te permite hacer también, y eso es lo que quiero mostrarte. Así que en este ejemplo, estoy usando algo que se llama App Actions. Así que déjame cambiar un poco esta prueba, guardarla ahora, y ejecutarla. Bien, lo tengo. Así que, Cypress aprovecha mucho el hecho de que se está ejecutando en el navegador. Ya te he mostrado un par de cosas, como imprimir cosas en la consola, tomar nota de lo que la aplicación está haciendo en la red, pero también, puedes echar un vistazo directamente al estado de la aplicación. Así que déjame mostrarte en la aplicación que tengo esta store.ts, que esta aplicación usa PNIA. Está escrita en Vue y para la gestión de la tienda utiliza este paquete pnia y utiliza este use store. Así que aquí dentro tengo todo el estado o todo el estado por defecto definido y también he definido algunas de las acciones que mutan este estado. Ahora lo que he hecho con mi aplicación para hacerla más testeable es que siempre que estamos probando, siempre que hay Cypress en el contexto de la ventana, estamos exponiendo el use store, así que todo el estado de la aplicación, a la variable de la tienda en el objeto de la ventana. Así que esto me permite acceder a las propiedades de la tienda e incluso a las funciones que mutan la tienda directamente desde el contexto de la ventana. Así que en Cypress tengo este comando cyWindow que accede al objeto de la ventana y luego puedo invocar diferentes funciones. Así que aquí estoy invocando la tienda y luego estoy invocando la función getBoredList que realmente dispara la llamada a la API para buscar todos los tableros en la base de datos. Dentro de aquí también tengo una función de pausa así que quizás incluso si estás usando Cypress no has oído hablar de esa pero es súper útil cuando estoy demostrando algo. Dentro de aquí puedo simplemente ir paso a paso y pasar al siguiente comando que es la llamada a la API. Así que estoy creando un nuevo tablero pero como puedes ver no está apareciendo en nuestra aplicación y esto es porque no tenemos algún tipo de conexión WebSocket a la base de datos o con el servidor que actualizaría el contenido de nuestra aplicación. Así que básicamente necesitaríamos recargar la aplicación para hacer que esa llamada getAPIBoards se active de nuevo.

Pero con AppActions, en realidad no tenemos que hacer eso porque invocaremos la tienda y luego llamaremos a la acción getBoardList que es responsable de buscar todos esos data del servidor y que es la función que se llama cada vez que abrimos la aplicación. Así que permíteme ir al siguiente paso. Obtenemos la ventana, obtenemos la tienda y ahora llamamos a getBoardList que desencadenará esta llamada a la API y nuestro tablero ahora está cargado. Así que con AppActions, podemos acceder a todo tipo de cosas. Incluso podemos acceder a las cosas que están ocultas en la aplicación. Así que permíteme comentar esto y mostrarte esto. Porque tengo algunas herramientas de API ocultas que hice para esta aplicación y ahora básicamente estoy llamando a toggleTools para que aparezcan y tengo estas bonitas y ordenadas herramientas de API disponibles para mí aquí y sí, accedí a esto usando el invoke y usando la tienda interna. Esta es una gran ventaja en comparación con quizás diferentes herramientas de automation de pruebas porque ya que estamos ejecutando en el navegador tenemos acceso directo a la aplicación, eso se opone a las herramientas que de alguna manera manejan el navegador y acceden al navegador de alguna manera desde fuera para automatizar acciones en el navegador. Ahora, por supuesto, esto tiene algunas ventajas y tiene algunas desventajas, pero yo veo esto como una gran victoria para Cypress cuando puede básicamente acceder a cualquier parte de tu aplicación a la que le das la autoridad y manipularla de una manera que te ayude a alcanzar quizás un caso difícil de alcanzar o alguna parte de tu aplicación que podría ser difícil de configurar debido a los data o debido a algunos otros factores. Ahora Cypress es, por supuesto, una gran herramienta para entrar en la aplicación y testing diferentes estados y hacer que la aplicación haga cosas para que podamos probarla de una mejor manera, pero podemos profundizar aún más y descomponer nuestra aplicación en trozos más pequeños. Así que Cypress ha lanzado esta característica asesina llamada pruebas de componentes. Así que recientemente salió de la beta, ha estado aquí durante bastante tiempo pero con la versión de Cypress 10 alcanzó a toda la multitud. Así que quiero mostrarte esto porque nuestra aplicación está construida a partir de diferentes componentes pequeños que conforman nuestra aplicación. Me gusta pensar en ello como una especie de bloques de Lego que se utilizan para construir la aplicación. Así que aquí básicamente estoy usando la función cyMount que va a renderizar mi componente y estoy pasando diferentes propiedades aquí. Así que si escribo hola mundo, mi botón aquí va a renderizar hola mundo. Si escribo hola test.js, va a renderizar esto. Así que puedo probar diferentes tipos de estados de mi componente y no tiene que ser un botón, podemos ir a algo más complicado. Así que, por ejemplo, podemos probar diferentes estados de nuestra notificación aquí, probar un mensaje de información o un mensaje de error, o podemos ir a nuestra barra de navegación, hacer clic en este icono de inicio y ver si se comporta de manera diferente cuando estamos en casa o cuando estamos en alguna otra subpágina. Incluso podemos renderizar subcomponentes, así que estos elementos desplegables en realidad contienen algunos componentes de slots en ellos y puedes ir básicamente a cualquier parte con esto. La mayor ventaja de esto es que llegamos a renderizar nuestros componentes dentro de un navegador real. Así es exactamente cómo se renderizarían nuestros componentes dentro de un navegador. Podemos interactuar con ellos, podemos probarlos como puedes ver, y obtenemos toda la api de cypress habilitada para nosotros, así que podemos probar diferentes estados. Si el componente llama a una API, podemos usar intercept para cambiar el estado. Podemos enviar solicitudes, podemos cambiar el estado de la aplicación usando la acción de la aplicación que acabo de mostrarte. O podemos simplemente renderizar múltiples componentes y ver cómo interactúan entre sí. Pero si estás haciendo eso, has llegado al círculo completo y vuelves a las pruebas de extremo a extremo testing. Puedes dar tantas vueltas como quieras, y esperamos que obtengas una buena cobertura de tu aplicación. Esto ha sido realmente divertido. Así que muchas gracias por escuchar hasta aquí. Estaré muy ansioso por conocerte en una de mis masterclasses, ya sea en el test.js summit o en noviembre en mi otra masterclass. Puedes encontrar el enlace en la parte inferior de esta presentación. Y ahora estaré muy ansioso por escuchar tus preguntas. Nos vemos en un rato.