Skip to content
On this page

Trabajar con Formularios

Ahora veremos las diversas maneras que tiene la API de Vue Testing Libray para probar formularios. Ante todo, vamos a crear el componente que será nuestro formulario @/components/MyForm.vue.

Empezamos en el <script> declarando una constante reactiva, con la función ref propia de Vue, llamada name e inicializada en "".

vue
<script setup>
import { ref } from 'vue'

const name = ref("")
</script>

Luego en el <template>, creamos un elemento form con el evento @submit.prevent que invocará a un método llamado submit. Seguido de un label para name y su respectivo input vinculando v-model a name, junto con la propiedad id establecida con name también.

vue
<template>
  <form @submit.prevent="submit">
    <label for="name">Name</label>
    <input v-model="name" id="name" />    
  </form>
</template>

Por último, agregamos un button de envio con el texto Submit y con el role de "button" porque obviamente esta es su función. También deshabilitaremos este botón, para que no se pueda enviar el formulario a menos que el usuario haya escrito su nombre. Si name no tiene length estará disabled, y cuando el usuario ingrese su nombre será cuando se habilitará este botón.

Entonces, nuestro @/components/MyForm.vue luce de la siguiente forma.

vue
<script setup>
import { ref } from 'vue'

const name = ref("")
</script>

<template>
  <form @submit.prevent="submit">
    <label for="name">Name</label>
    <input v-model="name" id="name" />
    <button role="button" :disabled="!name.length">Submit</button>
  </form>
</template>

Veamos ahora cómo podemos escribir esta prueba, en el correspondiente archivo partiremos de lo más básico.

js
// tests/components/myform.spec.js
import { render, screen } from "@testing-library/vue"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)   
  })
  
  // screen...
})

Lo primero que probaremos es que haya un botón deshabilitado, por lo que debemos antes seleccionarlo. Así que para ello podemos usar screen con el método getByRole, pasando como primer argumento "button".

Luego, para buscar el botón específico, pasamos un objeto con el atributo name declarado en "Submit" como segundo argumento. Es decir, primero buscará el role="button" y luego verificará que el texto diga Submit.

js
// tests/components/myform.spec.js
import { render, screen } from "@testing-library/vue"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)

    screen.getByRole("button", { name: "Submit" })   
  })
})

Esta es una manera de seleccionar elementos con Vue Testing Library que funciona muy bien.

Podemos comprobarlo agregando cualquier cosa dentro de la propiedad name, solo para estropearlo y verificar si sucede un error sino encuentra el elemento correcto.

js
// tests/components/myform.spec.js
import { render, screen } from "@testing-library/vue"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)

    screen.getByRole("button", { name: "asdfSubmit" })   
  })
})

Guardemos y observaremos que la prueba fallará, queriéndonos decir que si funciona correctamente.

❯ tests/components/myform.spec.js:10:12
      8|     render(MyForm)
      9|                                                                                                                             
     10|     screen.getByRole("button", {name: "asdfSubmit"})                                                                        
       |            ^                                                                                                                
     11|   })                                                                                                                        
     12| })                                                                                                                          

⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯[1/1]⎯

Test Files  1 failed | 1 passed (2)
     Tests  1 failed | 6 passed (7)
      Time  1.98s (in thread 387ms, 512.59%)

Ahora comprobaremos, con el método toBeDisabled, que el botón está deshabilitado. Este es otro método que proviene de @testing-library/jest-dom.

js
// tests/components/myform.spec.js
import { render, screen } from "@testing-library/vue"
import "@testing-library/jest-dom"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)

    expect(
      screen.getByRole("button", { name: "Submit" })
    ).toBeDisabled()   
  })
})

Al guardar podemos comprobar que la prueba pasará.

Seguidamente, podemos hacer una pequeña refactorización para que no se vea tan largo. Vamos a extraer lo que retorna el método screen.getByRole en una constante llamada button. No es obligatorio hacer esto, pero de esta manera nos resultará más fácil reutilizarla.

js
// tests/components/myform.spec.js
import { render, screen } from "@testing-library/vue"
import "@testing-library/jest-dom"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)

    const button = screen.getByRole("button", {name: "Submit"})
    expect(button).toBeDisabled()   
  })
})

Sigamos adelante para completar la prueba.

Ya hemos visto antes cómo desencadenar eventos usando fireEvent. En este caso activaremos el evento update el cual funcionará específicamente con el v-model, esto nos permitirá actualizar las entradas.

js
fireEvent.update(
  screen.getByLabelText('Name'), 'John'
)

El primer argumento será la entrada a actualizar, por lo que debemos seleccionar el elemento correcto.

En el caso de Vue Testing Library ya sabemos que le gusta alentarnos a ser accesibles y lo que haría un usuario es buscar una entrada basada en el texto.

Para este caso vamos a usar el selector getByLabelText al cual le pasaremos Name como primer argumento, de esta manera tendremos el elemento correcto que queremos seleccionar.

Luego, como segundo argumento, podemos continuar pasándole el nombre específico que queremos colocar, completando así la entrada del formulario.

js
// tests/components/myform.spec.js
import { render, screen, fireEvent } from "@testing-library/vue"
import "@testing-library/jest-dom"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)

    const button = screen.getByRole("button", {name: "Submit"})
    expect(button).toBeDisabled()
    
    fireEvent.update(
      screen.getByLabelText('Name'), 'John'
    )  
  })
})

Así que guardemos y comprobaremos que no está fallando la prueba. Como ya sabemos, getByLabelText generaría un error sino encontrara el argumento. Por lo que esta prueba está funcionando correctamente.

Finalmente, sigamos adelante y escribamos otra afirmación revirtiendo la anterior para corroborar que está deshabilitado el botón.

js
// tests/components/myform.spec.js
import { render, screen, fireEvent } from "@testing-library/vue"
import "@testing-library/jest-dom"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)

    const button = screen.getByRole("button", {name: "Submit"})
    expect(button).toBeDisabled()
    
    fireEvent.update(
      screen.getByLabelText('Name'), 'John'
    )

    expect(button).not.toBeDisabled()
  })
})

Si guardamos esto, en realidad va a fallar.

❯ tests/components/myform.spec.js:17:24
     15|     )
     16|                                                                                             
     17|     expect(button).not.toBeDisabled()                                                       
       |                        ^                                                                    
     18|   })                                                                                        
     19| })                                                                                          

⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯[1/1]⎯

Test Files  1 failed (1)
     Tests  1 failed (1)
      Time  124ms

Esto es otro problema similar que vimos antes.

La solución de Vue Test Utils lo puede resolver con el método nextTick de Vue.

js
// tests/components/myform.spec.js
import { render, screen, fireEvent } from "@testing-library/vue"
import { nextTick } from "vue"
import "@testing-library/jest-dom"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)

    const button = screen.getByRole("button", {name: "Submit"})
    expect(button).toBeDisabled()
    
    fireEvent.update(
      screen.getByLabelText('Name'), 'John'
    )

    await nextTick()

    expect(button).not.toBeDisabled()
  })  
})

Guardamos y esto pasará.

Pero, realmente queremos hacerlo de la manera más ideomática de Vue Testing Library, ya que hay algunas maneras en que se puede hacer esto.

Podría ser colocando await antes del método fireEvent.update, esto tendría un efecto similar al método nextTick.

js
// tests/components/myform.spec.js
import { render, screen, fireEvent } from "@testing-library/vue"
import "@testing-library/jest-dom"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)

    const button = screen.getByRole("button", {name: "Submit"})
    expect(button).toBeDisabled()
    
    await fireEvent.update(
      screen.getByLabelText('Name'), 'John'
    )

    expect(button).not.toBeDisabled()
  })
})

O tal vez preferimos usar waitFor para envolver la afirmación y esperar hasta que pase.

js
// tests/components/myform.spec.js
import { render, screen, fireEvent, waitFor } from "@testing-library/vue"
import "@testing-library/jest-dom"
import MyForm from "@/components/MyForm.vue"

describe("MyForm.vue", () => {
  it("enable button when data is entered", async () => {    
    render(MyForm)

    const button = screen.getByRole("button", {name: "Submit"})
    expect(button).toBeDisabled()
    
    fireEvent.update(
      screen.getByLabelText('Name'), 'John'
    )

    waitFor(() => {      
      expect(button).not.toBeDisabled()
    })
  })
})

Al guardar, también comprobará que esto funciona.

Dejaremos esta lección hasta aquí y en la proxima, veremos cómo podemos probar que el evento ha sido llamado de forma correcta y también veremos cómo podemos probar los eventos emitidos.