Presentamos Spectate, una biblioteca de código abierto que genera la lógica de estado de tu React utilizando las pruebas que escribes.
Video Summary and Transcription
Esta charla presenta Spectate, una biblioteca que genera aplicaciones basadas en pruebas. El orador demuestra cómo construir un formulario de registro de correo electrónico utilizando Spectate, escribiendo pruebas para manejar errores de correo electrónico y contraseña vacíos. Explican cómo funciona Spectate simulando pruebas para construir un modelo y actualizando el estado de la aplicación según la entrada del usuario. Spectate selecciona el estado más similar del modelo y ejecuta las acciones correspondientes. La charla concluye animando a los oyentes a explorar las características y ejemplos de Spectate.
Available in English
1. Introducción a la biblioteca Spectate
Short description:
Hola a todos. Gracias por unirse. Mi nombre es Ed Bentley, un desarrollador front-end que utiliza principalmente React. Hoy voy a hablar sobre pruebas e introducir mi biblioteca llamada Spectate. Te permite generar una aplicación basada en pruebas. Permíteme mostrarte una demostración en vivo de Spectate con una aplicación simple de React.
Hola a todos. Gracias por unirse. Mi nombre es Ed Bentley. Soy un desarrollador front-end. Utilizo principalmente React. Puedes encontrarme en Twitter. También soy un desarrollador de juegos independiente. Esta es mi empresa Flute Games. Tenemos un nuevo juego que saldrá este año. Así que mantente atento a eso. También he desarrollado mi propio open-source JavaScript game engine llamado Replay. Está muy inspirado en React. Así que, si estás interesado en hacer juegos, te recomiendo que lo revises.
Pero hoy voy a hablar sobre pruebas. Normalmente, cuando estamos escribiendo nuestras aplicaciones, escribimos la aplicación. Y luego escribimos las pruebas. Ahora, por supuesto, si seguimos el desarrollo basado en pruebas, entonces podríamos hacer esto al revés. Para la interfaz de usuario, siento que tendemos a hacer esto mucho más. Pero encuentro que esto lleva mucho tiempo. Estaba construyendo mis interfaces de menú el otro día, y realmente me resultó difícil motivarme para escribir las pruebas después de haber pasado mucho tiempo escribiendo todo el código. Y si lo piensas, estamos duplicando mucho del comportamiento. Estamos escribiendo la aplicación y luego escribimos la prueba de nuevo. Y ambos tienen el mismo tipo de comportamiento en ellos. Así que tuve una idea. Pensé, ¿qué tal si pudieras simplemente escribir las pruebas, agitar una especie de varita mágica y luego de un cofre aparece tu aplicación.
Ahora, tomándolo en serio por un momento, si escribiera algunas pruebas como código y te las entregara, probablemente podrías escribir la aplicación en sí, basándote en la lectura de las pruebas. Pero ¿qué pasaría si un programa pudiera hacer eso por ti? Simplemente escribes las pruebas, y luego el programa es capaz de generar la aplicación para ti. Ahora, he tomado esta idea y he construido una biblioteca llamada Spectate. Ahora quiero mostrarte Spectate hoy, y tengo una demostración en vivo.
2. Construyendo un Formulario de Registro de Correo Electrónico con Spectate
Short description:
Estoy usando Vite. Un saludo a Vite. Planeo construir un formulario de registro de correo electrónico usando Spectate. Escribimos el marcado en React, y Spectate actúa como nuestro gestor de estado. Comenzamos con una etiqueta e input de correo electrónico, seguido de un input de contraseña y un botón de registro. Para agregar comportamiento, escribimos pruebas usando new spec y definimos una prueba para registrarse con correo electrónico y contraseña.
Entonces, aquí tengo una aplicación muy simple de React. Estoy usando Vite. Un saludo a Vite. Y en este momento, solo muestra 'Hola, mundo'. Así que, lo que planeo construir es un formulario de registro de correo electrónico usando Spectate. Ahora, aún escribimos el marcado en React, y Spectate será nuestro gestor de estado , por lo que todo lo que hacemos en React es puramente funcional.
Entonces, voy a comenzar con una etiqueta de correo electrónico y su input. Ahora, esto no será el HTML más semánticamente correcto ni seguirá las mejores prácticas, como no estamos usando un formulario. Lo estoy escribiendo de la manera más simple y concisa posible hoy. También podríamos tener un input de contraseña. Y luego queremos un botón para registrarse, botón de registro. Bien. Ya he hecho algo de estilizado aquí. Así que básicamente se verá así. Pero ahora mismo no hace nada. Así que para agregar este comportamiento, vamos a escribir algunas pruebas. Las llamamos specs. Así que voy a escribir myspec es igual a, y hay una función cuyo argumento es new spec. El tipo de esto es new spec. Puedes usar esto si estás usando TypeScript, te ayudará con el autocompletado. Luego vamos a definir una nueva prueba, como cuando escribimos pruebas con jest. Vamos a escribir new spec y luego una descripción. Así que vamos a decir que podemos registrarnos con correo electrónico y contraseña. Ahora, aquí habrá algunas funciones útiles. Sé lo que necesitamos de antemano. Será hacer clic en un texto final, hacer efecto y ser igual a.
Entonces, lo que vamos a hacer, pensemos en este formulario de correo electrónico por un momento, queremos agregar una dirección de correo electrónico, agregar una contraseña y luego hacer clic en registrarse. Así que lo que vamos a necesitar es un input, así que podemos llamarlo input de correo electrónico y usamos el nuevo input. También necesitamos un texto para almacenar lo que ingresamos en el input, así que lo llamaremos texto de correo electrónico y esta es una variable de texto. Ahora, este input está conectado a nuestra variable de texto, para hacer eso, para mostrar que está conectado, simplemente lo pasaremos aquí. Voy a copiar esto y hacer lo mismo para la contraseña.
3. Escribiendo la Prueba de Registro y Agregándola a la Aplicación
Short description:
Ahora vamos a escribir esta prueba. Haremos clic en el input de correo electrónico, ingresaremos un correo electrónico, haremos clic en el input de contraseña, ingresaremos una contraseña y haremos clic en el botón de registro. Cuando hagamos clic en el botón de registro, registraremos el post. Para agregarlo a nuestra aplicación, usamos el hook useSpec y propagamos las props. Vamos a mejorarlo cambiando el tipo de input a contraseña y obteniendo los valores de correo electrónico y contraseña en nuestro post.
Ahora tenemos un campo de texto para la contraseña y, por supuesto, también tenemos el botón de registro.
Bien, hemos definido esos elementos, también necesitamos devolverlos para que Spectate pueda usarlos. Así que voy a devolver el campo de texto de correo electrónico, el input de correo electrónico, el campo de texto de contraseña, el input de contraseña y el botón de registro.
Muy bien, ahora vamos a escribir esta prueba. Vamos a pensar en esto por un segundo. Primero, lo que vamos a hacer es hacer clic en el input y esto se parece a algo como React Testing Library, que es una gran biblioteca, un saludo a eso. Así que vamos a hacer clic en el input de correo electrónico y luego vamos a ingresar un texto y vamos a escribir algún tipo de correo electrónico, hola@test.com. Luego vamos a hacer clic en el input de contraseña y luego vamos a ingresar algún tipo de contraseña y luego hacemos clic en el botón de registro.
Ahora, hemos descrito este comportamiento, pero ¿qué estamos haciendo realmente cuando hacemos clic en el botón de registro? Para fines de esta demostración, simplemente voy a registrar en la consola. Para hacer eso, necesitamos crear un efecto. Ahora esto se llama, llamémoslo postJson y podemos usar este nuevo efecto que toma una función que solo tiene nuestros efectos, similar a useEffect. Puedes ver de dónde obtuve lainspiration. Simplemente vamos a registrar el post aquí.
Muy bien, volviendo a nuestra prueba, cuando hacemos clic en el botón de registro necesitamos realmente hacer el efecto y el efecto es postJson. Muy bien, eso es todo. Ahora tenemos que agregarlo a nuestra aplicación y aquí hay una API muy simple. Nuestras props están definidas por un hook llamado useSpec. useSpec se importa de nuestra biblioteca, spec.txt, y aquí pasamos nuestra función que definimos, mySpec. Muy bien, ahora miramos las props y podemos ver que tiene todos los campos que definimos anteriormente en nuestra función. Así que convenientemente podemos simplemente propagar las props. Tenemos el input de correo electrónico, podemos simplemente propagar las props, lo mismo con el input de contraseña y nuevamente propagar las props del botón de registro. Y esto está diseñado para ser lo más simple posible porque realmente estamos dedicando nuestro tiempo a escribir las pruebas y no tenemos que pasar mucho tiempo escribiendo el marcado en sí mismo.
Muy bien, tengo eso, veamos qué sucede. Escribo un correo electrónico, escribo una contraseña, ahí lo tenemos, hemos registrado un post. Después de hacer clic en el botón de registro. Um, vamos a mejorar esto un poco. En primer lugar, no me gusta cómo se muestra la contraseña, necesitamos cambiar el tipo de input. Así que aquí podemos simplemente decir que el tipo de input es contraseña, pero aún queremos que esté conectado a la variable de texto de contraseña, para que sepa qué variable actualizar. Lo otro que quiero hacer es en nuestro
4. Manejo del Error de Correo Electrónico Vacío
Short description:
Podemos obtener el valor de nuestro correo electrónico y contraseña. El efecto es llamado por nuestro botón de registro. Sin embargo, si no hay correo electrónico o contraseña, aún intenta enviar una solicitud de publicación. Para manejar este caso, escribimos otro caso de prueba que muestra un error si el correo electrónico está vacío. Después de hacer clic en el botón de registro, el texto de error se establecerá como 'hey, el correo electrónico no puede estar vacío'. Necesitamos mostrar el texto de error en la aplicación devolviéndolo desde la función.
post, quiero obtener realmente ese valor de correo electrónico y contraseña que ingresamos. Así que voy a ingresar getval aquí, que tiene un argumento que podemos usar para obtener el valor como una cadena de nuestras variables. Entonces podemos decir texto de correo electrónico, podemos obtener el valor de nuestro texto de contraseña, así de simple. Puedes ver que nuestro tipo de entrada ha cambiado. Hacemos clic en registrarse, y ahí lo tenemos. Está enviando nuestro correo electrónico y nuestra contraseña. Por lo tanto, este efecto podría ser cualquier cosa que desees. Podría ser una solicitud fetch. Podría ser una solicitud GraphQL. El efecto está aquí y es llamado por nuestro botón de registro. Bien, esto es genial, pero tenemos un problema. Si no tenemos una contraseña o un correo electrónico, aún intenta enviar una solicitud de publicación. Lo que queremos es decirle al usuario: `Oh, tienes un correo electrónico vacío`. ¿Cómo manejamos este caso? Simplemente escribimos otro caso de prueba. Así que vamos a definirlo. Tenemos una nueva especificación. Ahora queremos decir, muestra un error si el correo electrónico está vacío. Nuevamente, queremos hacer clic en y equals, por lo que en este caso, no hemos interactuado con los elementos del formulario en absoluto. Vamos directamente a hacer clic en enviar nuestro botón, porque no hay correo electrónico, no hay contraseña. Y luego habrá una acción después de eso. Ahora vamos a necesitar agregar un texto adicional para que nos dé un mensaje de error útil. Así que aquí voy a definir el texto de error. Así. Y luego decimos que después de hacer clic en este botón de registro, nuestro texto de error va a ser igual a 'hey, el correo electrónico no puede estar vacío'. Y solo por completitud, después de haberse registrado correctamente, voy a decir que el texto de error es una cadena vacía, solo para borrar eso. Por último, solo necesitamos mostrar el texto de error en la aplicación. Y tenemos que volver a nuestro marcado de React aquí. Así que podemos decir props. Y por supuesto, no olvides, necesitamos devolver esta variable de texto desde la función, para que podamos usarla con React como una prop. Así que tenemos nuestro texto de error. Y luego tenemos un span, que tengo aquí para algún deslizamiento.
5. Manejo del Error de Contraseña Vacía
Short description:
Haz clic en registrarse. Me dice que el correo electrónico no puede estar vacío. Voy a agregar un correo electrónico. Lo que queremos que diga es que tienes una contraseña vacía. Agregamos otro caso de prueba. Mostramos que el texto de error es que la contraseña no puede estar vacía. Genial, la contraseña no puede estar vacía. Ahora agregamos nuestra contraseña. Y se envía. Este es un ejemplo de cómo puedes construir un formulario de registro de correo electrónico usando Spectate.
Error, y su valor será el propio texto de error.
De acuerdo, vamos a intentarlo. Haz clic en registrarse. Me dice que el correo electrónico no puede estar vacío. De acuerdo. Voy a agregar un correo electrónico. Ah, me está dando una advertencia, porque Spectate no sabe qué hacer en este caso. ¿Debería mostrarte una advertencia sobre tu correo electrónico? ¿Debería enviar en formato JSON? No lo sé. Lo que queremos que diga es que tienes una contraseña vacía. Entonces, ¿cómo manejamos esto? Agregamos otro caso de prueba. Así que voy a copiar lo que teníamos antes. Pero esta vez muestra un error para una contraseña vacía. Ahora, voy a copiar este correo electrónico que ingresamos anteriormente porque en este caso, ya hemos ingresado un correo electrónico. Pero luego hacemos clic en el botón de registro. Así. Hemos hecho clic en el campo de correo electrónico. Hemos ingresado un texto. Y luego hicimos clic en el botón de registro. Y luego mostramos que el texto de error es, la contraseña no puede estar vacía. De acuerdo, vamos a probar esto. Genial, la contraseña no puede estar vacía. Ahora agregamos nuestra contraseña. Y se envía. Y nuevamente, si lo borramos, aún muestra el mensaje de error de correo electrónico, no el mensaje de error de contraseña. De acuerdo, y ese es un ejemplo de cómo puedes construir un formulario de registro de correo electrónico usando Spectate. Puedes ver que no necesitamos escribir ninguna prueba. Hemos escrito las pruebas. Y las pruebas mismas han generado el tipo de lógica de la aplicación, el comportamiento de la aplicación. Y eso es todo. Y puedes
6. Explicando cómo funciona Spectate
Short description:
Hay más cosas como listas que no hemos cubierto hoy. Pero eso es realmente la esencia de lo que Spectate puede hacer. Ahora, es posible que estés pensando, esto es mucha magia. Realmente no entiendo cómo funciona esto. Así que voy a tratar de explicar cómo Spectate está funcionando en este caso. Tomamos nuestra primera especificación y la simulamos para construir un modelo basado en ella. Comenzamos con nuestro propio estado interno definido por variables. También tenemos un campo de enfoque que rastrea en qué se enfoca el navegador. Al ejecutar la especificación, actualizamos el texto del correo electrónico y la contraseña según la entrada del usuario.
Podemos usar estos como bloques de construcción para construir aplicaciones más complicadas. Hay más cosas como listas que no hemos cubierto hoy. Pero eso es realmente la esencia de lo que Spectate puede hacer.Ahora, es posible que estés pensando, esto es mucha magia. Realmente no entiendo cómo funciona esto. Y la magia generalmente no es buena para nosotros, los desarrolladores. Así que voy a tratar de explicar cómo Spectate está funcionando en este caso. Tomamos nuestra primera especificación. Y como se dijo, puede registrarse con un correo electrónico y una contraseña. Entonces lo que vamos a hacer es, cuando la aplicación se carga por primera vez, Spectate va a ejecutar todas tus especificaciones. Y las va a simular, y va a construir un modelo basado en ellas. Así que imaginemos que estamos construyendo este modelo. Comenzamos con nuestro propio estado interno a la izquierda. Este estado interno está definido por las variables que hemos definido en la función de especificación. Así que creamos un texto de correo electrónico con un nuevo texto. Creamos un texto de contraseña y creamos un texto de error. Entonces este estado interno ha comenzado con todas las cadenas como valores vacíos.Ahora, también tenemos este campo de enfoque. Esto simplemente estará vacío, porque en este momento no hay nada en foco. Pero esto está mirando en qué se enfoca el navegador. Ahora vamos a ejecutar la especificación. Hicimos clic en el campo de entrada de correo electrónico. Así que ahora nuestro enfoque está en el campo de entrada de correo electrónico. Luego hicimos clic en, ingresamos texto. Así que hemos actualizado nuestro texto de correo electrónico. El campo de entrada está enfocado. El campo de entrada estaba conectado al texto. Así que el valor del texto ahora se ha actualizado. Luego hicimos clic en el campo de entrada de contraseña, y eso cambió el enfoque al campo de entrada de contraseña. Y luego ingresamos el texto de la contraseña.
7. Analizando el Comportamiento de la Aplicación con Spectate
Short description:
Hicimos clic en el botón de registro y guardamos el estado. Luego analizamos el estado y las acciones que siguieron en diferentes casos, como cuando había un correo electrónico o contraseña vacíos. Después de construir un modelo, imaginamos usar la aplicación como usuario y observamos cómo Spectate selecciona el estado más similar del modelo y ejecuta las acciones correspondientes. Por ejemplo, estableciendo el texto de error como 'el correo electrónico no puede estar vacío' cuando el campo de correo electrónico estaba vacío. Cuando se ingresó un correo electrónico, el texto del correo electrónico era 'hello@gmail.com'.
Ahora este es el paso crítico. Hicimos clic en el botón de registro. Ahora no vamos a ejecutar lo que sucede después del botón de registro en ese recuadro rojo. Solo vamos a guardarlo. Y vamos a ver el estado actualmente. Y simplemente lo vamos a agregar a nuestro modelo. Así que hemos guardado. Bien, cuando la aplicación estaba en este estado, hicimos estos efectos, este efecto y esto es igual. Y luego pasaremos al siguiente paso. Entonces, en este caso, mostraba un error. Si hay un correo electrónico vacío, volvemos a comenzar con un estado vacío. Hicimos clic en el botón de registro. Y eso se convirtió directamente en una acción. Así que simplemente lo agregamos de nuevo al modelo. Nuevamente, tenemos este estado y las acciones que lo siguieron en ese estado. Y el caso final, que fue cuando había una contraseña vacía. Hicimos clic en el campo de entrada de correo electrónico, nuevamente, enfocamos el campo de entrada de correo electrónico. Ingresamos algún texto para tener algún texto de correo electrónico. Hicimos clic en el botón de registro. Miramos el estado cuando hicimos clic en el botón y las acciones que lo precedieron, que lo siguieron. Y luego los agregamos al modelo.
Bien, ahora hemos construido un modelo. Ahora imagina que realmente estamos usando esta aplicación como usuario. Ahora vamos a comenzar con un estado interno nuevamente que se va a rastrear mientras usas la aplicación. Podemos ver la aplicación aquí. Ahora pensemos en esto. ¿Qué sucede si haces clic en el botón de registro? Lo que Spectate va a hacer es buscar en el modelo y decir, ¿dónde está el estado ahora, más similar a un caso que vi antes en el modelo? Entonces va a seleccionar este caso donde todos los campos de estado estaban vacíos. Y luego va a ejecutar esas acciones, por lo que va a establecer el texto de error como 'el correo electrónico no puede estar vacío', básicamente un estado establecido. Y luego vemos visualmente que el correo electrónico no puede estar vacío. ¿Qué pasa con el siguiente caso cuando ingresamos un correo electrónico? Ahora notarás que aquí el texto del correo electrónico es una cadena 'hello@gmail.com'.
8. Explorando las Funcionalidades y Ejemplos de Spectate
Short description:
En nuestro modelo, Spectate compara los valores de cadena para determinar el estado más similar. Selecciona el estado basado en el estado vacío o no vacío de los campos de correo electrónico y contraseña. Cuando ambos campos están completos, Spectate ejecuta las acciones y envía el correo electrónico y la contraseña. Spectate es un proyecto de código abierto disponible en GitHub. Puedes explorar un sitio web de demostración en vivo con ejemplos, incluyendo una aplicación de tareas pendientes. Gracias por escuchar y te animo a probar esta nueva forma de construir interfaces de usuario. No dudes en conectarte conmigo en Twitter.
Pero en nuestro modelo, el más similar fue este caso donde teníamos 'hi' en test.com. Ahora, Spectate no compara valores exactos para las cadenas. Solo va a verificar si la cadena está vacía o no. No es perfecto, pero en realidad es genial para muchos casos. Así que estamos viendo aquí. Este ciertamente es el estado más similar porque el texto de la contraseña está vacío, el texto de error está vacío y el texto del correo electrónico no está vacío. Por lo tanto, elegimos la acción aquí, igual al texto de error, que resulta ser 'la contraseña no puede estar vacía'. Y luego lo vemos en la pantalla.
Ahora, el caso final, ¿qué sucede cuando hemos completado ambos campos? Creo que ya puedes adivinarlo. Tenemos un texto de correo electrónico, tenemos un texto de contraseña. Por lo tanto, va a seleccionar este estado en el modelo, y luego va a tomar esas acciones y ejecutarlas. Y así terminamos enviando el correo electrónico y la contraseña.
Bien, eso es Spectate. Puedes encontrarlo en GitHub. Es un proyecto de código abierto. Lo último que quiero hacer es mostrarte algunos ejemplos más de lo que puede hacer. Aquí tienes un sitio web de demostración en vivo. Está enlazado en la página de GitHub. Así que échale un vistazo. Puedes ver algunos ejemplos de lo que puedes construir. Está la típica aplicación de tareas pendientes, que creo que todo gestor de estado debe tener. Así que puedes decir, alimentar al gato, regar las plantas. Y podemos marcar estas tareas pendientes a medida que se completan. Y todo esto está escrito con Spectate. Y puedes ver todo el código aquí. Te agradezco por escucharme. Espero que esto haya despertado cierta curiosidad para que lo pruebes. Esta es una forma completamente nueva de construir interfaces de usuario. Échale un vistazo, juega con él y ve qué puedes construir. Y nuevamente, puedes encontrarme en Twitter. Muchas gracias por escuchar.
