docs: add the portuguese documentation

docs/.vuepress/config.js

@@ -24,6 +24,11 @@ module.exports = {
       title: 'Vue Test Utils',
       lang: 'fr',
       description: 'Utilitaires pour tester les composants Vue'
+    },
+    '/pt/': {
+      title: 'Vue Test Utils',
+      lang: 'pt',
+      description: 'Utilitários para testes de componentes de Vue'
     }
   },
   plugins: ['@vuepress/pwa'],
@@ -203,6 +208,41 @@ module.exports = {
           '/fr/api/options',
           '/fr/api/components/'
         ]
+      },
+      '/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/'
+        ]
       }
     }
   },

docs/pt/README.md

@@ -0,0 +1,93 @@
+# Introdução
+
+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)

docs/pt/api/README.md

@@ -0,0 +1,11 @@
+# API
+
+!!!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)!!!

docs/pt/api/components/README.md

@@ -0,0 +1,5 @@
+# Componentes
+
+A Vue Test Utils inclui utilitários de componentes que você pode usar para forjar componentes.
+
+!!!include(docs/pt/api/components/RouterLinkStub.md)!!!

docs/pt/api/components/RouterLinkStub.md

@@ -0,0 +1,20 @@
+## O componente RouterLinkStub
+
+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:
+
+```js
+import { mount, RouterLinkStub } from '@vue/test-utils'
+
+const wrapper = mount(Component, {
+  stubs: {
+    RouterLink: RouterLinkStub
+  }
+})
+expect(wrapper.findComponent(RouterLinkStub).props().to).toBe('/some/path')
+```

docs/pt/api/config.md

@@ -0,0 +1,114 @@
+## Configuração
+
+A Vue Test Utils incluem um objeto de configuração para as opções definidas usadas pela Vue Test Utils.
+
+### Opções de Configuração da Vue Test Utils
+
+### `showDeprecationWarnings`
+
+- 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:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.showDeprecationWarnings = false
+```
+
+### `deprecationWarningHandler`
+
+- 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:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.showDeprecationWarnings = true
+config.deprecationWarningHandler = (method, message) => {
+  if (method === 'emittedByOrder') return
+
+  console.error(message)
+}
+```
+
+### `stubs`
+
+- 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:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.stubs['my-component'] = '<div />'
+```
+
+### `mocks`
+
+- 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:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.mocks['$store'] = {
+  state: {
+    id: 1
+  }
+}
+```
+
+### `methods`
+
+- 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:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.methods['getData'] = () => {}
+```
+
+### `provide`
+
+- 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:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.provide['$logger'] = {
+  log: (...args) => {
+    console.log(...args)
+  }
+}
+```

docs/pt/api/createLocalVue.md

@@ -0,0 +1,59 @@
+## O método createLocalVue()
+
+- **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:**
+
+```js
+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):**
+
+```js
+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
+})
+
+// Foo lança um erro dentro um gatilho do ciclo de vida
+const wrapper = shallowMount(Foo, {
+  localVue
+})
+```
+
+- **Consulte também:** [Dicas Comuns](../guides/common-tips.md#applying-global-plugins-and-mixins)

docs/pt/api/createWrapper.md

@@ -0,0 +1,25 @@
+## O método createWrapper(node [, options])
+
+- **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.
+
+```js
+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)
+```