},

'/pt/': {

title: 'Vue Test Utils',

lang: 'pt',

description: 'Utilitários para testes de componentes de Vue'

},

'/pt/': {

label: 'Português',

selectText: 'Idiomas',

editLinkText: 'Edite esta página no GitHub',

nav: [

{

text: 'API',

link: '/pt/api/'

},

{

text: 'Guias',

link: '/pt/guides/',

items: [

{

text: '2.x-beta',

link: 'https://next.vue-test-utils.vuejs.org/guide/'

}

]

},

{

text: 'Atualizando para V1',

link: '/pt/upgrading-to-v1/'

}

],

sidebar: [

'/pt/',

'/pt/installation/',

'/pt/guides/',

'/pt/api/',

'/pt/api/wrapper/',

'/pt/api/wrapper-array/',

'/pt/api/options',

'/pt/api/components/'

]

Vue Test Utils é a biblioteca oficial de testes unitários para o Vue.js.

Esta é a documentação para o Vue Test Utils versão 1, a qual se foca no Vue.js 2 e suas atualizações mais recentes.

Em resumo:

- [Vue Test Utils 1](https://github.com/vuejs/vue-test-utils/) é dedicado ao [Vue 2](https://github.com/vuejs/vue/).

- [Vue Test Utils 2](https://github.com/vuejs/vue-test-utils-next/) é dedicado ao [Vue 3](https://github.com/vuejs/vue-next/).

<div class="vueschool"><a href="https://vueschool.io/courses/learn-how-to-test-vuejs-components?friend=vuejs" target="_blank" rel="sponsored noopener" title="Aprenda a usar Vue Test Utils para testar componentes Vue.js com Vue School">Aprenda a testar componentes Vue.js com Vue School</a></div>

- [Introdução](./installation/)

- [Guias](./guides/)

- [Começar agora](./guides/getting-started.md)

- [Dicas Gerais](guides/common-tips.md)

- [Mouse, Teclado e outros eventos do DOM](guides/dom-events.md)

- [Testando Comportamento Assíncronos](guides/testing-async-components.md)

- [Usando com TypeScript](guides/using-with-typescript.md)

- [Usando com Vue Router](guides/using-with-vue-router.md)

- [Usando com Vuex](guides/using-with-vuex.md)

- [Bibliotecas Úteis para Testes](guides/useful-libraries-for-testing.md)

- [API](api/)

- [mount](api/mount.md)

- [shallowMount](api/shallowMount.md)

- [render](api/render.md)

- [renderToString](api/renderToString.md)

- [Opções de Montagem](api/options.md)

- [context](api/options.md#context)

- [data](api/options.md#data)

- [slots](api/options.md#slots)

- [scopedSlots](api/options.md#scopedslots)

- [stubs](api/options.md#stubs)

- [mocks](api/options.md#mocks)

- [localVue](api/options.md#localvue)

- [attachTo](api/options.md#attachto)

- [attachToDocument](api/options.md#attachtodocument)

- [attrs](api/options.md#attrs)

- [propsData](api/options.md#propsdata)

- [listeners](api/options.md#listeners)

- [parentComponent](api/options.md#parentComponent)

- [provide](api/options.md#provide)

- [other options](api/options.md#outras-opções)

- [Wrapper](api/wrapper/)

- [attributes](api/wrapper/attributes.md)

- [classes](api/wrapper/classes.md)

- [contains](api/wrapper/contains.md)

- [destroy](api/wrapper/destroy.md)

- [emitted](api/wrapper/emitted.md)

- [emittedByOrder](api/wrapper/emittedByOrder.md)

- [exists](api/wrapper/exists.md)

- [find](api/wrapper/find.md)

- [findAll](api/wrapper/findAll.md)

- [findAllComponents](api/wrapper/findAllComponents.md)

- [findComponent](api/wrapper/findComponent.md)

- [get](api/wrapper/get.md)

- [html](api/wrapper/html.md)

- [is](api/wrapper/is.md)

- [isEmpty](api/wrapper/isEmpty.md)

- [isVisible](api/wrapper/isVisible.md)

- [isVueInstance](api/wrapper/isVueInstance.md)

- [name](api/wrapper/name.md)

- [props](api/wrapper/props.md)

- [setChecked](api/wrapper/setChecked.md)

- [setData](api/wrapper/setData.md)

- [setMethods](api/wrapper/setMethods.md)

- [setProps](api/wrapper/setProps.md)

- [setSelected](api/wrapper/setSelected.md)

- [setValue](api/wrapper/setValue.md)

- [text](api/wrapper/text.md)

- [trigger](api/wrapper/trigger.md)

- [WrapperArray](api/wrapper-array/)

- [at](api/wrapper-array/at.md)

- [contains](api/wrapper-array/contains.md)

- [destroy](api/wrapper-array/destroy.md)

- [filter](api/wrapper-array/filter.md)

- [is](api/wrapper-array/is.md)

- [isEmpty](api/wrapper-array/isEmpty.md)

- [isVisible](api/wrapper-array/isVisible.md)

- [isVueInstance](api/wrapper-array/isVueInstance.md)

- [setChecked](api/wrapper-array/setChecked.md)

- [setData](api/wrapper-array/setData.md)

- [setMethods](api/wrapper-array/setMethods.md)

- [setProps](api/wrapper-array/setProps.md)

- [setValue](api/wrapper-array/setValue.md)

- [trigger](api/wrapper-array/trigger.md)

- [Componentes](api/components/)

- [RouterLinkStub](api/components/RouterLinkStub.md)

- [Seletores](api/selectors.md)

- [createWrapper](api/createWrapper.md)

- [createLocalVue](api/createLocalVue.md)

- [config](api/config.md)

!!!include(docs/pt/api/mount.md)!!!

!!!include(docs/pt/api/shallowMount.md)!!!

!!!include(docs/pt/api/render.md)!!!

!!!include(docs/pt/api/renderToString.md)!!!

!!!include(docs/pt/api/selectors.md)!!!

!!!include(docs/pt/api/createLocalVue.md)!!!

!!!include(docs/pt/api/createWrapper.md)!!!

!!!include(docs/pt/api/config.md)!!!

!!!include(docs/pt/api/enableAutoDestroy.md)!!!

A Vue Test Utils inclui utilitários de componentes que você pode usar para forjar componentes.

!!!include(docs/pt/api/components/RouterLinkStub.md)!!!

Um componente para forjar o componente `router-link` do Vue Router.

Você pode usar este componente para achar um componente `router-link` dentro da árvore de renderização.

- **Uso:**

Definir ele como um componente forjado dentro das opções de montagem:

import { mount, RouterLinkStub } from '@vue/test-utils'

const wrapper = mount(Component, {

stubs: {

RouterLink: RouterLinkStub

}

})

expect(wrapper.findComponent(RouterLinkStub).props().to).toBe('/some/path')

A Vue Test Utils incluem um objeto de configuração para as opções definidas usadas pela Vue Test Utils.

- tipo: `Boolean`

- valor padrão: `true`

Controla se ou não mostrar avisos de depreciação. Quando definida para `true`, todos avisos de depreciação são visíveis na consola.

Exemplo:

import { config } from '@vue/test-utils'

config.showDeprecationWarnings = false

- tipo: `Function`

Permite controle delicado sobre os avisos de depreciação. Quando `showDeprecationWarnings` é definido para `true`, todos avisos de depreciação serão passados para este manipulador com o nome do método como primeiro argumento e a mensagem original como segundo argumento.

::: tip

Isto poderia ser útil para registar mensagens de depreciação para separar a localização ou ajudar numa atualização gradual de base de código para última versão do utilitários de teste pela ignorância de certas funções de avisos depreciadas

:::

Exemplo:

import { config } from '@vue/test-utils'

config.showDeprecationWarnings = true

config.deprecationWarningHandler = (method, message) => {

if (method === 'emittedByOrder') return

console.error(message)

}

- tipo: `{ [name: string]: Component | boolean | string }`

- valor padrão: `{}`

O forjado guardado dentro de `config.stubs` é usado por padrão.

Forjados para usar dentro de componentes. Estes são sobrescritos pelo `stubs` passado dentro das opções em montagem.

Quando estiver passando `stubs` como um arranjo dentro de opções em montagem, os `config.stubs` são convertidos para um arranjo, e forjarão componentes com um componente básico que retornam `<${component name}-stub>`.

Exemplo:

import { config } from '@vue/test-utils'

config.stubs['my-component'] = '<div />'

- tipo: `Object`

- valor padrão: `{}`

Tal como nos `stubs`, os valores passados para o `config.mocks` são usados por padrão. Quaisquer valores passados para as opções de montagem do objeto `mocks` terão prioridade sobre aqueles declarados dentro de `config.mocks`.

Exemplo:

import { config } from '@vue/test-utils'

config.mocks['$store'] = {

state: {

id: 1

}

}

- tipo: `{ [name: string]: Function }`

- valor padrão: `{}`

Você pode configurar métodos padrão usando o objeto `config`. Isto podem ser útil para plugins que injetam métodos aos componentes, tal como o [VeeValidate](https://logaretm.github.io/vee-validate/). Você pode sobrescrever métodos definidos dentro de `config` ao passar os `methods` dentro das opções em montagem.

Exemplo:

import { config } from '@vue/test-utils'

config.methods['getData'] = () => {}

- tipo: `Object`

- valor padrão: `{}`

Tal como em `stubs` ou `mocks`, os valores passados para o `config.provide` são usados por padrão. Quaisquer valores passados para opções em montagem do objeto `provide` terão prioridade sobre aqueles declarados dentro de `config.provide`. **Por favor repare que isto não é suportado para passar uma função como `config.provide`.**

Exemplo:

import { config } from '@vue/test-utils'

config.provide['$logger'] = {

log: (...args) => {

console.log(...args)

}

}

- **Argumentos:**

- `{Object} options`

- `{Function} errorHandler`

- **Retorna:**

- `{Component}`

- **Uso:**

O `createLocalVue` retorna uma classe do Vue para você adicionar componentes, mixins (combinadores) e instalar plugins sem poluir a classe global do Vue.

A opção `errorHandler` pode ser usada para manipular erros não capturados durante a função de renderizar do componente e observadores.

Use ele com `options.localVue`:

**Sem as opções:**

import { createLocalVue, shallowMount } from '@vue/test-utils'

import MyPlugin from 'my-plugin'

import Foo from './Foo.vue'

const localVue = createLocalVue()

localVue.use(MyPlugin)

const wrapper = shallowMount(Foo, {

localVue,

mocks: { foo: true }

})

expect(wrapper.vm.foo).toBe(true)

const freshWrapper = shallowMount(Foo)

expect(freshWrapper.vm.foo).toBe(false)

**Com a opção [`errorHandler`](https://vuejs.org/v2/api/#errorHandler):**

import { createLocalVue, shallowMount } from '@vue/test-utils'

import Foo from './Foo.vue'

const errorHandler = (err, vm, info) => {

expect(err).toBeInstanceOf(Error)

}

const localVue = createLocalVue({

errorHandler

})

const wrapper = shallowMount(Foo, {

localVue

})

- **Consulte também:** [Dicas Comuns](../guides/common-tips.md#applying-global-plugins-and-mixins)

- **Argumentos:**

- `{vm|HTMLElement} node`

- `{Object} options`

- `{Boolean} attachedToDocument`

- **Retorna:**

- `{Wrapper}`

- **Uso:**

O `createWrapper` cria um `Wrapper` para uma instância do Vue montada, ou um elemento HTML.

import { createWrapper } from '@vue/test-utils'

import Foo from './Foo.vue'

const Constructor = Vue.extend(Foo)

const vm = new Constructor().$mount()

const wrapper = createWrapper(vm)

expect(wrapper.vm.foo).toBe(true)