Skip to content
On this page

Consultas DOM

Vue Testing Library es bastante similar a Vue Test Utils, discutiremos un poco sobre esto y hablaremos sobre algunas de las diferencias. Ya que es un poco más obstinado y trae opiniones interesantes para debatir. Empecemos...

Para ahorrar un poco de tiempo, empecemos con el componente HelloWorld.vue que trae la instalación de Vue 3 por defecto. Para la cual, crearemos el siguiente archivo de prueba:

js
// tests/components/helloworld.spec.js
import { shallowMount } from "@vue/test-utils"
import HelloWorld from "@/components/HelloWorld.vue"

describe("HelloWorld.vue", () => {
  it("renders props.msg when passed", () => {
    const msg = "new message"
    const wrapper = shallowMount(HelloWorld, {
      props: { msg }
    })
    expect(wrapper.text()).toMatch(msg)
  })
})

Lo primero que haremos será eliminar el shallowMount ya que no usaremos "@vue/test-utils". Así que avancemos actualizando nuestras importaciones con "@testing-library/vue".

Luego tomemos el método render, esto permitirá renderizar sus componentes. Este es el único medio de renderizar cosas en Testing Library, ya no devolverá un envoltorio. Sí devuelve un objeto, pero contiene métodos, por una razón muy diferente. Así que por el momento, eliminaré la constante wrapper.

Las opciones de montaje, como props, serán similares. Temporalmente, comentaremos la aserción y simplemente ejecutaremos las pruebas en modo de observación, para obtener ese buen ciclo de retroalimentación rápida.

js
// tests/components/helloworld.spec.js
import { render } from "@testing-library/vue"
import HelloWorld from "@/components/HelloWorld.vue"

describe("HelloWorld.vue", () => {
  it("renders props.msg when passed", () => {
    const msg = "new message"
    render(HelloWorld, {
      props: { msg }
    })
    //expect(wrapper.text()).toMatch(msg)    
  })
})

Todo debería estar bien hasta aquí, así que sigamos adelante y continuemos actualizando nuestra aserción.

Para ello, vamos a afirmar que el texto aparece en el documento. Hay varias formas de hacer esto. La primera es desestructurar el valor de retorno del render, esto tiene la cantidad de acciones que el usuario puede tomar y dentro de poco hablaremos más sobre lo que significa eso. Pero avancemos y veamos nuestra afirmación.

En este caso, queremos usar el getByText el cual nos permitirá obtener cualquier elemento en el DOM usando el texto. Así que ahora podemos seguir adelante y actualicemos nuestra afirmación.

js
// tests/components/helloworld.spec.js
import { render } from "@testing-library/vue"
import HelloWorld from "@/components/HelloWorld.vue"

describe("HelloWorld.vue", () => {
  it("renders props.msg when passed", () => {
    const msg = "new message"
    const { getByText } = render(HelloWorld, {
      props: { msg }
    })
    expect(getByText(msg)).toBeTruthy()    
  })
})

Pero vamos a usar coincidencias más expresivas. Por lo que importaremos otra biblioteca y veremos como funciona, se trata de "@testing-library/jest-dom". Lo que esto hará es darnos una serie de afirmaciones adicionales en nuestra declaración expect.

En este caso, estamos buscando un nodo dom que contiene un mensaje de texto y estamos afirmando que está en el documento. Eso va afirmar que este elemento existe en algún lugar del DOM.

js
// tests/components/helloworld.spec.js
import { render } from "@testing-library/vue"
import "@testing-library/jest-dom"
import HelloWorld from "@/components/HelloWorld.vue"

describe("HelloWorld.vue", () => {
  it("renders props.msg when passed", () => {
    const msg = "new message"
    const { getByText } = render(HelloWorld, {
      props: { msg }
    })
    expect(getByText(msg)).toBeTruthy()
    expect(getByText(msg)).toBeInTheDocument()
  })
})

Espero que pase...

√ tests/components/helloworld.spec.js (1)

Test Files  1 passed (1)
     Tests  1 passed (1)
      Time  1.82s (in thread 49ms, 3721.69%)

... y efectivamente pasó.