Skip to content
On this page

Montando Componentes

Muchas pruebas, independientemente del framework o el tipo, siguen un formato similar: Arreglar, Actuar y Afirmar. Este patrón "Arreglar, Actuar, Afirmar" fue acuñado por primera vez en 2001 por Bill Wilke y se explica detalladamente en su publicación de blog "3A - Arreglar, Actuar, Afirmar".

Cuando se trata de pruebas de componentes, el montaje de su componente es donde Arreglamos nuestro componente bajo prueba. Es similar a visitar una página en una prueba de extremo a extremo (end-to-end).

¿Qué es la función Mount?

Enviamos una función mount para cada framework de frontend compatible con Cypress, que se importa del paquete cypress. Es responsable de renderizar los componentes dentro del iframe de espacio aislado (sandboxed) de Cypress y del manejo y la limpieza específica del framework.

js
import { mount } from 'cypress/vue'

Usando cy.mount() En Cualquier Lugar

Si bien puede usar la función mount en sus pruebas, recomendamos usar cy.mount(), que se agrega como un comando personalizado en el archivo cypress/support/component.js:

📃cypress/support/component.js

js
import { mount } from 'cypress/vue'

Cypress.Commands.add('mount', mount)

Esto le permite usar cy.mount() en cualquier prueba de componente sin tener que importar el comando de montaje específico del framework.

Puede personalizar cy.mount para que se ajuste a sus necesidades. Por ejemplo, si está utilizando complementos u otras configuraciones globales a nivel de aplicación en su aplicación Vue, puede configurarlas aquí. Para obtener más información, consulte la Guía de Personalización de cy.mount() para Vue.

Su Primera Prueba de Componentes

Ahora que tiene un componente, escribamos una especificación que monte el componente.

Para comenzar, cree un archivo de especificaciones en el mismo directorio que el componente Stepper.vue y asígnele el nombre Stepper.cy.js. Luego pega lo siguiente en él:

📃Stepper.cy.js

js
import Stepper from './Stepper.vue'

describe('<Stepper>', () => {
  it('mounts', () => {
    cy.mount(Stepper)
  })
})

Aquí, tenemos una sola prueba que asegura que nuestro componente se monta.

Si ya tiene un componente para el que desea crear una especificación, podemos crear la especificación por usted a través de la aplicación Cypress.

Haga clic en "+ New Spec", seleccione "Create from component" y elija su componente de la lista.

mouting-components

Crear a partir de la tarjeta de componentes

mouting-components

Crear a partir de la lista de componentes

INFO

Si viene de Vue Test Utils, tenga en cuenta que no se usa el valor de retorno de mount. Las pruebas de Cypress Component pueden y deben ser independientes de los componentes internos del framework y rara vez es necesario acceder al wrapper en el que se basan Vue Test Utils.

Ejecución de la Prueba

Ahora es el momento de ver la prueba en acción. Abra Cypress si aún no se está ejecutando:

bash
npx cypress open --component

::: La bandera --component nos llevará directamente a la prueba de componentes :::

Y abre el navegador de tu elección. En la lista de especificaciones, haga clic en Stepper.cy.js y verá el componente paso a paso montado en el área de prueba.

mouting-components

Prueba de Montaje Stepper

Una prueba básica que monta un componente en su estado predeterminado es una excelente manera de comenzar a probar. Dado que Cypress representa su componente en un navegador real, tiene muchas ventajas, como ver que el componente se representa como debería, interactuar con el componente en el ejecutor de pruebas y usar las herramientas de desarrollo del navegador para inspeccionar y depurar ambas pruebas y el código del componente.

Siéntase libre de jugar con el componente Stepper interactuando con los botones de incremento y decremento.

Soporte JSX opcional

El comando mount es compatible con la sintaxis de objetos de Vue Test Utils, pero también se puede usar con la sintaxis JSX de Vue (siempre que haya configurado su paquete para admitir la transpilación de archivos JSX o TSX).

La sintaxis del objeto para la función mount es idéntica a la versión de Vue Test Utils que usaría con la versión de Vue de su aplicación.

El resto de esta guía mostrará pruebas en la sintaxis de Vue Test Utils. Para JSX consulte la documentación oficial de Cypress.

Cypress y Testing Library

Si bien Cypress no usa Testing Library en su guía, muchas personas podrían preguntarse si es posible hacerlo con Cypress y la respuesta es ¡sí!

Cypress ama el proyecto Testing Library. Utiliza Testing Library internamente, y su filosofía se alinea estrechamente con el espíritu y el enfoque de Testing Library para escribir pruebas. Apoyamos firmemente sus mejores prácticas.

En particular, si está buscando más recursos para comprender cómo le recomendamos que enfoque las pruebas de sus componentes, consulte:

Para los fanáticos de Testing Library, querrá instalar @testing-library/cypress en lugar del paquete @testing-library/vue.

bash
npm i -D @testing-library/cypress

Las instrucciones de configuración son las mismas para E2E y Pruebas de Componentes. Dentro de su archivo de soporte de componentes, importe los comandos personalizados.

js
// cypress/support/component.js
// cy.findBy* commands will now be available.
// This calls Cypress.Commands.add under the hood
import '@testing-library/cypress/add-commands'

Para los usuarios de TypeScript, los tipos se empaquetan junto con el paquete Testing Library. Consulte las instrucciones de configuración más recientes en los documentos de Testing Library.

Próximos Pasos

Ahora que tenemos nuestro componente montado, a continuación aprenderemos cómo escribir pruebas contra él.