From 968449298c5c40175e764288c0cae5295d6542b3 Mon Sep 17 00:00:00 2001 From: yoandry Date: Wed, 21 Aug 2019 16:13:22 -0400 Subject: [PATCH 01/13] Fix: Translate Testing Overview doc to spanish --- content/docs/testing.md | 35 ++++++++++++++++++----------------- 1 file changed, 18 insertions(+), 17 deletions(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index cf2de4c44..7a0c9790f 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -7,34 +7,35 @@ redirect_from: next: testing-recipes.html --- -You can test React components similar to testing other JavaScript code. +Puedes probar un componente de React similar a como pruebas otro código JavaScript. -There are a few ways to test React components. Broadly, they divide into two categories: -* **Rendering component trees** in a simplified test environment and asserting on their output. -* **Running a complete app** in a realistic browser environment (also known as “end-to-end” tests). +Hay varias formas de probar un componente React, la mayoría se agrupan en dos categorías: -This documentation section focuses on testing strategies for the first case. While full end-to-end tests can be very useful to prevent regressions to important workflows, such tests are not concerned with React components in particular, and are out of scope of this section. +* **Renderizado del árbol de componentes** en un entorno de prueba simplificado y comprobación de sus salidas. +* **Ejecutando la aplicación completa** en un entorno de prueba más realista utilizando un navegador web. ( más conocido como pruebas “end-to-end”). -### Tradeoffs {#tradeoffs} +Esta sección de la documentación está enfocada en estrategias de prueba para el primer caso. Mientras las pruebas de tipo “end-to-end” pueden ser muy útiles para prever regresiones a flujos de trabajos importantes, estas pruebas no están relacionadas con los componentes React particularmente y están fuera del alcance de esta sección. +### Concesiones {#tradeoffs} -When choosing testing tools, it is worth considering a few tradeoffs: -* **Iteration speed vs Realistic environment:** Some tools offer a very quick feedback loop between making a change and seeing the result, but don't model the browser behavior precisely. Other tools might use a real browser environment, but reduce the iteration speed and are flakier on a continuous integration server. -* **How much to mock:** With components, the distinction between a "unit" and "integration" test can be blurry. If you're testing a form, should its test also test the buttons inside of it? Or should a button component have its own test suite? Should refactoring a button ever break the form test? +Cuando estás eligiendo las herramientas para realizar las pruebas, vale la pena considerar algunas Concesiones: -Different answers may work for different teams and products. +* **Velocidad de iteración vs Entorno realista:** Algunas herramientas ofrecen un ciclo de retroalimentación muy rápido entre hacer un cambio y ver el resultado, pero no modelan el comportamiento del navegador con precisión. Otras herramientas pueden usar un entorno de navegador real, pero reducen la velocidad de iteración y son menos confiables en un servidor de integración continua. +* **Cuanto abarcar:** Cuando pruebas componentes la disferencia entre Prueba Unitaria y Prueba de Integración puede ser borrosa. Si estas probando un formularion, Se deben probar los botones del formulario en la prueba del formulario? o debe tener el componente button su propia suit de pruebas? Deberia la refactorizacion del boton afectar el resultado de las pruebas del formulario? -### Recommended Tools {#tools} +Disferentes respuestas deben funcionar para disferentes equipos y disferentes productos. -**[Jest](https://facebook.github.io/jest/)** is a JavaScript test runner that lets you access the DOM via [`jsdom`](#mocking-a-rendering-surface). While jsdom is only an approximation of how the browser works, it is often good enough for testing React components. Jest provides a great iteration speed combined with powerful features like mocking [modules](#mocking-modules) and [timers](#mocking-timers) so you can have more control over how the code executes. +### Herramientas recomendadas {#tools} -**[React Testing Library](https://testing-library.com/react)** is a set of helpers that let you test React components without relying on their implementation details. This approach makes refactoring a breeze and also nudges you towards best practices for accessibility. Although it doesn't provide a way to "shallowly" render a component without its children, a test runner like Jest lets you do this by [mocking](/docs/testing-recipes.html#mocking-modules). +**[Jest](https://facebook.github.io/jest/)** Es una libreria JavaScript para la ejecución de pruebas que permite acceder al DOM via [`jsdom`](#mocking-a-rendering-surface). Aunque JSDOM solo se aproxima a como realmente los navegadores web trabajan es suficiente para probar los componentes React. Jest brinda una gran velocidad de iteración convinada con potentes funcionalidades como moking [modules](#mocking-modules) y temporizadores [timers](#mocking-timers) esto permite tener mayor control sobre como se ejecuta el codigo. -### Learn More {#learn-more} +**[React Testing Library](https://testing-library.com/react)** es una libreria de utilidades que te ayudan a probar componentes React sin depender de los detalles de su implementación. Este enfoque simplifica la refactorización y también lo empuja hacia las mejores prácticas de accesibilidad, Aunque no proporciona una forma de renderizar "superficialmente" un componente sin sus hijos, Jest te permite hacerlo gracias a su funcionalidad [mocking](/docs/testing-recipes.html#mocking-modules). -This section is divided in two pages: +### Más Información {#learn-more} -- [Recipes](/docs/testing-recipes.html): Common patterns when writing tests for React components. -- [Environments](/docs/testing-environments.html): What to consider when setting up a testing environment for React components. +Esta sección esta dividida en dos paginas: + +- [Recipes](/docs/testing-recipes.html): Patrones comunes cuando escribes Pruebas para los componentes React. +- [Environments](/docs/testing-environments.html): Que debes conciderar cuando estes configurando un entorno de pruebas para componentes React. From 24d66190ef6c23a409cc9a859b56134660743d9c Mon Sep 17 00:00:00 2001 From: Yoandry Date: Thu, 22 Aug 2019 16:13:29 -0400 Subject: [PATCH 02/13] Update content/docs/testing.md Remove unnecessary space. Co-Authored-By: Miguel Alejandro Bolivar Portilla --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 7a0c9790f..13a94ba5e 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -13,7 +13,7 @@ Puedes probar un componente de React similar a como pruebas otro código JavaScr Hay varias formas de probar un componente React, la mayoría se agrupan en dos categorías: * **Renderizado del árbol de componentes** en un entorno de prueba simplificado y comprobación de sus salidas. -* **Ejecutando la aplicación completa** en un entorno de prueba más realista utilizando un navegador web. ( más conocido como pruebas “end-to-end”). +* **Ejecutando la aplicación completa** en un entorno de prueba más realista utilizando un navegador web (más conocido como pruebas “end-to-end”). Esta sección de la documentación está enfocada en estrategias de prueba para el primer caso. Mientras las pruebas de tipo “end-to-end” pueden ser muy útiles para prever regresiones a flujos de trabajos importantes, estas pruebas no están relacionadas con los componentes React particularmente y están fuera del alcance de esta sección. From ac4ad14f3dcf678e60924ddc18f30789bd8b3811 Mon Sep 17 00:00:00 2001 From: Yoandry Date: Thu, 22 Aug 2019 16:14:30 -0400 Subject: [PATCH 03/13] Update content/docs/testing.md Remove unnecessary space. Co-Authored-By: Miguel Alejandro Bolivar Portilla --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 13a94ba5e..d198fbd3d 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -15,7 +15,7 @@ Hay varias formas de probar un componente React, la mayoría se agrupan en dos c * **Renderizado del árbol de componentes** en un entorno de prueba simplificado y comprobación de sus salidas. * **Ejecutando la aplicación completa** en un entorno de prueba más realista utilizando un navegador web (más conocido como pruebas “end-to-end”). -Esta sección de la documentación está enfocada en estrategias de prueba para el primer caso. Mientras las pruebas de tipo “end-to-end” pueden ser muy útiles para prever regresiones a flujos de trabajos importantes, estas pruebas no están relacionadas con los componentes React particularmente y están fuera del alcance de esta sección. +Esta sección de la documentación está enfocada en estrategias de prueba para el primer caso. Mientras las pruebas de tipo “end-to-end” pueden ser muy útiles para prever regresiones a flujos de trabajos importantes, estas pruebas no están relacionadas con los componentes React particularmente y están fuera del alcance de esta sección. ### Concesiones {#tradeoffs} From 517022722a8140e8c6581d750137df9ce8cd9519 Mon Sep 17 00:00:00 2001 From: Yoandry Date: Thu, 22 Aug 2019 16:20:24 -0400 Subject: [PATCH 04/13] Update content/docs/testing.md Grammatically corrections Co-Authored-By: Miguel Alejandro Bolivar Portilla --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index d198fbd3d..8b1f8b35b 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -23,7 +23,7 @@ Esta sección de la documentación está enfocada en estrategias de prueba para Cuando estás eligiendo las herramientas para realizar las pruebas, vale la pena considerar algunas Concesiones: * **Velocidad de iteración vs Entorno realista:** Algunas herramientas ofrecen un ciclo de retroalimentación muy rápido entre hacer un cambio y ver el resultado, pero no modelan el comportamiento del navegador con precisión. Otras herramientas pueden usar un entorno de navegador real, pero reducen la velocidad de iteración y son menos confiables en un servidor de integración continua. -* **Cuanto abarcar:** Cuando pruebas componentes la disferencia entre Prueba Unitaria y Prueba de Integración puede ser borrosa. Si estas probando un formularion, Se deben probar los botones del formulario en la prueba del formulario? o debe tener el componente button su propia suit de pruebas? Deberia la refactorizacion del boton afectar el resultado de las pruebas del formulario? +* **Cuanto abarcar:** Cuando pruebas componentes la diferencia entre Prueba Unitaria y Prueba de Integración puede ser borrosa. Si estas probando un formulario, se deben probar los botones del formulario en esta prueba? O el componente del botón debe tener su propia suit de pruebas? Debería la refactorización del botón afectar el resultado de las pruebas del formulario? Disferentes respuestas deben funcionar para disferentes equipos y disferentes productos. From 3d7d549609de191169f18bda7cc7bf9071f53fbe Mon Sep 17 00:00:00 2001 From: Yoandry Date: Thu, 22 Aug 2019 16:22:13 -0400 Subject: [PATCH 05/13] Update content/docs/testing.md Co-Authored-By: Miguel Alejandro Bolivar Portilla --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 8b1f8b35b..7f8069005 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -31,7 +31,7 @@ Disferentes respuestas deben funcionar para disferentes equipos y disferentes pr **[Jest](https://facebook.github.io/jest/)** Es una libreria JavaScript para la ejecución de pruebas que permite acceder al DOM via [`jsdom`](#mocking-a-rendering-surface). Aunque JSDOM solo se aproxima a como realmente los navegadores web trabajan es suficiente para probar los componentes React. Jest brinda una gran velocidad de iteración convinada con potentes funcionalidades como moking [modules](#mocking-modules) y temporizadores [timers](#mocking-timers) esto permite tener mayor control sobre como se ejecuta el codigo. -**[React Testing Library](https://testing-library.com/react)** es una libreria de utilidades que te ayudan a probar componentes React sin depender de los detalles de su implementación. Este enfoque simplifica la refactorización y también lo empuja hacia las mejores prácticas de accesibilidad, Aunque no proporciona una forma de renderizar "superficialmente" un componente sin sus hijos, Jest te permite hacerlo gracias a su funcionalidad [mocking](/docs/testing-recipes.html#mocking-modules). +**[Biblioteca de Pruebas para React](https://testing-library.com/react)** es una biblioteca de utilidades que te ayudan a probar componentes React sin depender de los detalles de su implementación. Este enfoque simplifica la refactorización y también lo empuja hacia las mejores prácticas de accesibilidad, aunque no proporciona una forma de renderizar "superficialmente" un componente sin sus hijos, Jest te permite hacerlo gracias a su funcionalidad para [simular](/docs/testing-recipes.html#mocking-modules). ### Más Información {#learn-more} From 0a2b1f28685d1556b4ddf7dfa4d2b53f7e073058 Mon Sep 17 00:00:00 2001 From: Yoandry Date: Thu, 22 Aug 2019 16:22:35 -0400 Subject: [PATCH 06/13] Update content/docs/testing.md Co-Authored-By: Miguel Alejandro Bolivar Portilla --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 7f8069005..37e67f27d 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -38,4 +38,4 @@ Disferentes respuestas deben funcionar para disferentes equipos y disferentes pr Esta sección esta dividida en dos paginas: - [Recipes](/docs/testing-recipes.html): Patrones comunes cuando escribes Pruebas para los componentes React. -- [Environments](/docs/testing-environments.html): Que debes conciderar cuando estes configurando un entorno de pruebas para componentes React. +- [Entornos](/docs/testing-environments.html): Que debes considerar cuando estes configurando un entorno de pruebas para componentes React. From 363fec794893e532613ae2e5b0339240346682bb Mon Sep 17 00:00:00 2001 From: Yoandry Date: Thu, 22 Aug 2019 16:23:06 -0400 Subject: [PATCH 07/13] Update content/docs/testing.md Co-Authored-By: Miguel Alejandro Bolivar Portilla --- content/docs/testing.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 37e67f27d..bdb824aa8 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -9,7 +9,6 @@ next: testing-recipes.html Puedes probar un componente de React similar a como pruebas otro código JavaScript. - Hay varias formas de probar un componente React, la mayoría se agrupan en dos categorías: * **Renderizado del árbol de componentes** en un entorno de prueba simplificado y comprobación de sus salidas. From 8e5201ba333ace23f0176ed55c6efcad588d194b Mon Sep 17 00:00:00 2001 From: Yoandry Date: Thu, 22 Aug 2019 16:32:31 -0400 Subject: [PATCH 08/13] Update content/docs/testing.md Co-Authored-By: Miguel Alejandro Bolivar Portilla --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index bdb824aa8..33ef6fa9e 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -24,7 +24,7 @@ Cuando estás eligiendo las herramientas para realizar las pruebas, vale la pena * **Velocidad de iteración vs Entorno realista:** Algunas herramientas ofrecen un ciclo de retroalimentación muy rápido entre hacer un cambio y ver el resultado, pero no modelan el comportamiento del navegador con precisión. Otras herramientas pueden usar un entorno de navegador real, pero reducen la velocidad de iteración y son menos confiables en un servidor de integración continua. * **Cuanto abarcar:** Cuando pruebas componentes la diferencia entre Prueba Unitaria y Prueba de Integración puede ser borrosa. Si estas probando un formulario, se deben probar los botones del formulario en esta prueba? O el componente del botón debe tener su propia suit de pruebas? Debería la refactorización del botón afectar el resultado de las pruebas del formulario? -Disferentes respuestas deben funcionar para disferentes equipos y disferentes productos. +Diferentes respuestas pueden funcionar para diferentes equipos y diferentes productos. ### Herramientas recomendadas {#tools} From 86808a2b16057fee9ba6e2d1b3c5d1c123753174 Mon Sep 17 00:00:00 2001 From: Yoandry Date: Thu, 22 Aug 2019 16:32:55 -0400 Subject: [PATCH 09/13] Update content/docs/testing.md Co-Authored-By: Miguel Alejandro Bolivar Portilla --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 33ef6fa9e..882276e93 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -36,5 +36,5 @@ Diferentes respuestas pueden funcionar para diferentes equipos y diferentes prod Esta sección esta dividida en dos paginas: -- [Recipes](/docs/testing-recipes.html): Patrones comunes cuando escribes Pruebas para los componentes React. +- [Recetas](/docs/testing-recipes.html): Patrones comunes cuando escribes pruebas para componentes React. - [Entornos](/docs/testing-environments.html): Que debes considerar cuando estes configurando un entorno de pruebas para componentes React. From e3c53cd304a8d6daa73f33c44e809b035e8d8137 Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Fri, 23 Aug 2019 09:08:08 -0400 Subject: [PATCH 10/13] Update testing.md --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 882276e93..09d7add03 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -11,7 +11,7 @@ Puedes probar un componente de React similar a como pruebas otro código JavaScr Hay varias formas de probar un componente React, la mayoría se agrupan en dos categorías: -* **Renderizado del árbol de componentes** en un entorno de prueba simplificado y comprobación de sus salidas. +* **Renderizado del árbol de componentes** en un entorno de prueba simplificado y comprobando sus salidas. * **Ejecutando la aplicación completa** en un entorno de prueba más realista utilizando un navegador web (más conocido como pruebas “end-to-end”). Esta sección de la documentación está enfocada en estrategias de prueba para el primer caso. Mientras las pruebas de tipo “end-to-end” pueden ser muy útiles para prever regresiones a flujos de trabajos importantes, estas pruebas no están relacionadas con los componentes React particularmente y están fuera del alcance de esta sección. From ad32600ce74f2c07888e23d2267d2cc1bf73ce3c Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Fri, 23 Aug 2019 09:11:23 -0400 Subject: [PATCH 11/13] Update testing.md --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 09d7add03..8b4685f44 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -28,7 +28,7 @@ Diferentes respuestas pueden funcionar para diferentes equipos y diferentes prod ### Herramientas recomendadas {#tools} -**[Jest](https://facebook.github.io/jest/)** Es una libreria JavaScript para la ejecución de pruebas que permite acceder al DOM via [`jsdom`](#mocking-a-rendering-surface). Aunque JSDOM solo se aproxima a como realmente los navegadores web trabajan es suficiente para probar los componentes React. Jest brinda una gran velocidad de iteración convinada con potentes funcionalidades como moking [modules](#mocking-modules) y temporizadores [timers](#mocking-timers) esto permite tener mayor control sobre como se ejecuta el codigo. +**[Jest](https://facebook.github.io/jest/)** Es una biblioteca de JavaScript para ejecución de pruebas que permite acceder al DOM mediante [`jsdom`](#mocking-a-rendering-surface). Aunque JSDOM solo se aproxima a como realmente los navegadores web trabajan, usualmente es suficiente para probar los componentes React. Jest brinda una gran velocidad de iteración combinada con potentes funcionalidades como simular [módulos](#mocking-modules) y [temporizadores](#mocking-timers) esto permite tener mayor control sobre como se ejecuta el código. **[Biblioteca de Pruebas para React](https://testing-library.com/react)** es una biblioteca de utilidades que te ayudan a probar componentes React sin depender de los detalles de su implementación. Este enfoque simplifica la refactorización y también lo empuja hacia las mejores prácticas de accesibilidad, aunque no proporciona una forma de renderizar "superficialmente" un componente sin sus hijos, Jest te permite hacerlo gracias a su funcionalidad para [simular](/docs/testing-recipes.html#mocking-modules). From b0458692093081d4ddd9b7cd7c3c46f91bc59485 Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Fri, 23 Aug 2019 09:26:09 -0400 Subject: [PATCH 12/13] Update testing.md --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 8b4685f44..8474c6ee7 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -1,6 +1,6 @@ --- id: testing -title: Testing Overview +title: Visión general de Pruebas permalink: docs/testing.html redirect_from: - "community/testing.html" From d88a6327a0a3eb7458d765b0f43f3258cceb9352 Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Fri, 23 Aug 2019 09:39:51 -0400 Subject: [PATCH 13/13] Update testing.md --- content/docs/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/testing.md b/content/docs/testing.md index 8474c6ee7..57cf76db5 100644 --- a/content/docs/testing.md +++ b/content/docs/testing.md @@ -28,7 +28,7 @@ Diferentes respuestas pueden funcionar para diferentes equipos y diferentes prod ### Herramientas recomendadas {#tools} -**[Jest](https://facebook.github.io/jest/)** Es una biblioteca de JavaScript para ejecución de pruebas que permite acceder al DOM mediante [`jsdom`](#mocking-a-rendering-surface). Aunque JSDOM solo se aproxima a como realmente los navegadores web trabajan, usualmente es suficiente para probar los componentes React. Jest brinda una gran velocidad de iteración combinada con potentes funcionalidades como simular [módulos](#mocking-modules) y [temporizadores](#mocking-timers) esto permite tener mayor control sobre como se ejecuta el código. +**[Jest](https://facebook.github.io/jest/)** Es una biblioteca de JavaScript para ejecución de pruebas que permite acceder al DOM mediante [`jsdom`](/docs/testing-environments.html#mocking-a-rendering-surface). Aunque JSDOM solo se aproxima a como realmente los navegadores web trabajan, usualmente es suficiente para probar los componentes React. Jest brinda una gran velocidad de iteración combinada con potentes funcionalidades como simular [módulos](/docs/testing-environments.html#mocking-modules) y [temporizadores](/docs/testing-environments.html#mocking-timers) esto permite tener mayor control sobre como se ejecuta el código. **[Biblioteca de Pruebas para React](https://testing-library.com/react)** es una biblioteca de utilidades que te ayudan a probar componentes React sin depender de los detalles de su implementación. Este enfoque simplifica la refactorización y también lo empuja hacia las mejores prácticas de accesibilidad, aunque no proporciona una forma de renderizar "superficialmente" un componente sin sus hijos, Jest te permite hacerlo gracias a su funcionalidad para [simular](/docs/testing-recipes.html#mocking-modules).