Skip to content

Commit 9627a80

Browse files
docs: add the portuguese documentation (#2082)
* docs(pt): prepare the ground to upload docs * docs(pt): add `docs/pt/README.md` translated * docs(pt): add `docs/pt/api/README.md` translated * docs(pt): add `docs/pt/api/components/README.md` translated * docs(pt): add `docs/pt/api/components/RouterLinkStub.md` translated * docs(pt): add `docs/pt/api/config.md` translated * docs(pt): add `docs/pt/api/createLocalVue.md` translated * docs(pt): add `docs/pt/api/createWrapper.md` translated * docs(pt): add `docs/pt/api/enableAutoDestroy.md` translated * docs(pt): add `docs/pt/api/mount.md` translated * docs(pt): add `docs/pt/api/options.md` translated * docs(pt): add `docs/pt/api/render.md` translated * docs(pt): add `docs/pt/api/renderToString.md` translated * docs(pt): add `docs/pt/api/selectors.md` translated * docs(pt): add `docs/pt/api/shallowMount.md` translated * docs(pt): add `docs/pt/api/wrapper-array/README.md` translated * docs(pt): add `docs/pt/api/wrapper-array/at.md` translated * docs(pt): add `docs/pt/api/wrapper-array/contains.md` translated * docs(pt): add `docs/pt/api/wrapper-array/destroy.md` translated * docs(pt): add `docs/pt/api/wrapper-array/exists.md` translated * docs(pt): add `docs/pt/api/wrapper-array/filter.md` translated * docs(pt): add `docs/pt/api/wrapper-array/is.md` translated * docs(pt): add `docs/pt/api/wrapper-array/isEmpty.md` translated * docs(pt): add `docs/pt/api/wrapper-array/isVisible.md` translated * docs(pt): add `docs/pt/api/wrapper-array/isVueInstance.md` translated * docs(pt): add `docs/pt/api/wrapper-array/setChecked.md` translated * docs(pt): add `docs/pt/api/wrapper-array/setData.md` translated * docs(pt): add `docs/pt/api/wrapper-array/setMethods.md` translated * docs(pt): add `docs/pt/api/wrapper-array/setProps.md` translated * docs(pt): add `docs/pt/api/wrapper-array/setValue.md` translated * docs(pt): add `docs/pt/api/wrapper-array/trigger.md` translated * docs(pt): add `docs/pt/api/wrapper/README.md` translated * docs(pt): add `docs/pt/api/wrapper/attributes.md` translated * docs(pt): add `docs/pt/api/wrapper/classes.md` translated * docs(pt): add `docs/pt/api/wrapper/contains.md` translated * docs(pt): add `docs/pt/api/wrapper/destroy.md` translated * docs(pt): add `docs/pt/api/wrapper/emitted.md` translated * docs(pt): add `docs/pt/api/wrapper/emittedByOrder.md` translated * docs(pt): add `docs/pt/api/wrapper/exists.md` translated * docs(pt): add `docs/pt/api/wrapper/find.md` translated * docs(pt): add `docs/pt/api/wrapper/findAll.md` translated * docs(pt): add `docs/pt/api/wrapper/findAllComponents.md` translated * docs(pt): add `docs/pt/api/wrapper/findComponent.md` translated * docs(pt): add `docs/pt/api/wrapper/get.md` translated * docs(pt): add `docs/pt/api/wrapper/getComponent.md` translated * docs(pt): add `docs/pt/api/wrapper/html.md` translated * docs(pt): add `docs/pt/api/wrapper/is.md` translated * docs(pt): add `docs/pt/api/wrapper/isEmpty.md` translated * docs(pt): add `docs/pt/api/wrapper/isVisible.md` translated * docs(pt): add `docs/pt/api/wrapper/isVueInstance.md` translated * docs(pt): add `docs/pt/api/wrapper/name.md` translated * docs(pt): add `docs/pt/api/wrapper/overview.md` translated * docs(pt): add `docs/pt/api/wrapper/props.md` translated * docs(pt): add `docs/pt/api/wrapper/setChecked.md` translated * docs(pt): add `docs/pt/api/wrapper/setData.md` translated * docs(pt): add `docs/pt/api/wrapper/setMethods.md` translated * docs(pt): add `docs/pt/api/wrapper/setProps.md` translated * docs(pt): add `docs/pt/api/wrapper/setSelected.md` translated * docs(pt): add `docs/pt/api/wrapper/setValue.md` translated * docs(pt): add `docs/pt/api/wrapper/text.md` translated * docs(pt): add `docs/pt/api/wrapper/trigger.md` translated * docs(pt): add `docs/pt/guides/README.md` translated * docs(pt): add `docs/pt/guides/common-tips.md` translated * docs(pt): add `docs/pt/guides/dom-events.md` translated * docs(pt): add `docs/pt/guides/getting-started.md` translated * docs(pt): add `docs/pt/guides/testing-async-components.md` translated * docs(pt): add `guides/useful-libraries-for-testing.md` translated * docs(pt): add `docs/pt/guides/using-with-typescript.md` translated * docs(pt): add `docs/pt/guides/using-with-vue-router.md` translated * docs(pt): add `docs/pt/guides/using-with-vuex.md` translated * docs(pt): add `docs/pt/installation/README.md` translated * docs(pt): add `docs/pt/installation/semantic-versioning.md` translated * docs(pt): add `installation/using-other-test-runners.md` translated * docs(pt): add `docs/pt/installation/using-with-jest.md` translated * docs(pt): add `docs/pt/upgrading-to-v1/README.md` translated * docs(pt): update the `docs/pt/README.md` to improve translation * docs(pt): update `docs/pt/api/README.md` to a more clean words * docs(pt): update the urls in `docs/pt/api/components/REAME.md` take advantage to update `docs/pt/api/createWrapper` to a more clean set of words. * docs(pt): update the urls in `docs/pt/api/wrapper-array/README.md` * docs(pt): update the urls in `docs/pt/api/wrapper/README.md` * docs(pt): update `docs/pt/api/wrapper/classes.md` to improve translation * docs(pt): update `docs/pt/api/wrapper/contains.md` to improve words * docs(pt): update `docs/pt/api/wrapper/emitted.md` to improve words * docs(pt): update `docs/pt/api/wrapper/overview.md` to improve words * docs(pt): update `docs/pt/api/wrapper/setMethods.md` to improve words * docs(pt): update the urls in `docs/pt/guides/README.md` * docs(pt): update `docs/pt/guides/dom-events.md` to improve words * docs(pt): update `docs/pt/guides/getting-started.md` to improve words * docs(pt): update `docs/pt/guides/using-with-vuex.md` to improve words * docs(pt): update the urls in `docs/pt/installation/README.md` * docs(pt): update `docs/pt/upgrading-to-v1/README.md` to improve words * docs(pt): update the `docs/.vuepress/config.js` * docs(pt): update translations made in `pt/api/wrapper/findComponent.md`
1 parent a989458 commit 9627a80

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

75 files changed

+4535
-0
lines changed

Diff for: docs/.vuepress/config.js

+40
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,11 @@ module.exports = {
2424
title: 'Vue Test Utils',
2525
lang: 'fr',
2626
description: 'Utilitaires pour tester les composants Vue'
27+
},
28+
'/pt/': {
29+
title: 'Vue Test Utils',
30+
lang: 'pt',
31+
description: 'Utilitários para testes de componentes de Vue'
2732
}
2833
},
2934
plugins: ['@vuepress/pwa'],
@@ -203,6 +208,41 @@ module.exports = {
203208
'/fr/api/options',
204209
'/fr/api/components/'
205210
]
211+
},
212+
'/pt/': {
213+
label: 'Português',
214+
selectText: 'Idiomas',
215+
editLinkText: 'Edite esta página no GitHub',
216+
nav: [
217+
{
218+
text: 'API',
219+
link: '/pt/api/'
220+
},
221+
{
222+
text: 'Guias',
223+
link: '/pt/guides/',
224+
items: [
225+
{
226+
text: '2.x-beta',
227+
link: 'https://next.vue-test-utils.vuejs.org/guide/'
228+
}
229+
]
230+
},
231+
{
232+
text: 'Atualizando para V1',
233+
link: '/pt/upgrading-to-v1/'
234+
}
235+
],
236+
sidebar: [
237+
'/pt/',
238+
'/pt/installation/',
239+
'/pt/guides/',
240+
'/pt/api/',
241+
'/pt/api/wrapper/',
242+
'/pt/api/wrapper-array/',
243+
'/pt/api/options',
244+
'/pt/api/components/'
245+
]
206246
}
207247
}
208248
},

Diff for: docs/pt/README.md

+93
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
# Introdução
2+
3+
Vue Test Utils é a biblioteca oficial de testes unitários para o Vue.js.
4+
5+
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.
6+
7+
Em resumo:
8+
9+
- [Vue Test Utils 1](https://github.com/vuejs/vue-test-utils/) é dedicado ao [Vue 2](https://github.com/vuejs/vue/).
10+
- [Vue Test Utils 2](https://github.com/vuejs/vue-test-utils-next/) é dedicado ao [Vue 3](https://github.com/vuejs/vue-next/).
11+
12+
<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>
13+
14+
- [Introdução](./installation/)
15+
- [Guias](./guides/)
16+
- [Começar agora](./guides/getting-started.md)
17+
- [Dicas Gerais](guides/common-tips.md)
18+
- [Mouse, Teclado e outros eventos do DOM](guides/dom-events.md)
19+
- [Testando Comportamento Assíncronos](guides/testing-async-components.md)
20+
- [Usando com TypeScript](guides/using-with-typescript.md)
21+
- [Usando com Vue Router](guides/using-with-vue-router.md)
22+
- [Usando com Vuex](guides/using-with-vuex.md)
23+
- [Bibliotecas Úteis para Testes](guides/useful-libraries-for-testing.md)
24+
- [API](api/)
25+
- [mount](api/mount.md)
26+
- [shallowMount](api/shallowMount.md)
27+
- [render](api/render.md)
28+
- [renderToString](api/renderToString.md)
29+
- [Opções de Montagem](api/options.md)
30+
- [context](api/options.md#context)
31+
- [data](api/options.md#data)
32+
- [slots](api/options.md#slots)
33+
- [scopedSlots](api/options.md#scopedslots)
34+
- [stubs](api/options.md#stubs)
35+
- [mocks](api/options.md#mocks)
36+
- [localVue](api/options.md#localvue)
37+
- [attachTo](api/options.md#attachto)
38+
- [attachToDocument](api/options.md#attachtodocument)
39+
- [attrs](api/options.md#attrs)
40+
- [propsData](api/options.md#propsdata)
41+
- [listeners](api/options.md#listeners)
42+
- [parentComponent](api/options.md#parentComponent)
43+
- [provide](api/options.md#provide)
44+
- [other options](api/options.md#outras-opções)
45+
- [Wrapper](api/wrapper/)
46+
- [attributes](api/wrapper/attributes.md)
47+
- [classes](api/wrapper/classes.md)
48+
- [contains](api/wrapper/contains.md)
49+
- [destroy](api/wrapper/destroy.md)
50+
- [emitted](api/wrapper/emitted.md)
51+
- [emittedByOrder](api/wrapper/emittedByOrder.md)
52+
- [exists](api/wrapper/exists.md)
53+
- [find](api/wrapper/find.md)
54+
- [findAll](api/wrapper/findAll.md)
55+
- [findAllComponents](api/wrapper/findAllComponents.md)
56+
- [findComponent](api/wrapper/findComponent.md)
57+
- [get](api/wrapper/get.md)
58+
- [html](api/wrapper/html.md)
59+
- [is](api/wrapper/is.md)
60+
- [isEmpty](api/wrapper/isEmpty.md)
61+
- [isVisible](api/wrapper/isVisible.md)
62+
- [isVueInstance](api/wrapper/isVueInstance.md)
63+
- [name](api/wrapper/name.md)
64+
- [props](api/wrapper/props.md)
65+
- [setChecked](api/wrapper/setChecked.md)
66+
- [setData](api/wrapper/setData.md)
67+
- [setMethods](api/wrapper/setMethods.md)
68+
- [setProps](api/wrapper/setProps.md)
69+
- [setSelected](api/wrapper/setSelected.md)
70+
- [setValue](api/wrapper/setValue.md)
71+
- [text](api/wrapper/text.md)
72+
- [trigger](api/wrapper/trigger.md)
73+
- [WrapperArray](api/wrapper-array/)
74+
- [at](api/wrapper-array/at.md)
75+
- [contains](api/wrapper-array/contains.md)
76+
- [destroy](api/wrapper-array/destroy.md)
77+
- [filter](api/wrapper-array/filter.md)
78+
- [is](api/wrapper-array/is.md)
79+
- [isEmpty](api/wrapper-array/isEmpty.md)
80+
- [isVisible](api/wrapper-array/isVisible.md)
81+
- [isVueInstance](api/wrapper-array/isVueInstance.md)
82+
- [setChecked](api/wrapper-array/setChecked.md)
83+
- [setData](api/wrapper-array/setData.md)
84+
- [setMethods](api/wrapper-array/setMethods.md)
85+
- [setProps](api/wrapper-array/setProps.md)
86+
- [setValue](api/wrapper-array/setValue.md)
87+
- [trigger](api/wrapper-array/trigger.md)
88+
- [Componentes](api/components/)
89+
- [RouterLinkStub](api/components/RouterLinkStub.md)
90+
- [Seletores](api/selectors.md)
91+
- [createWrapper](api/createWrapper.md)
92+
- [createLocalVue](api/createLocalVue.md)
93+
- [config](api/config.md)

Diff for: docs/pt/api/README.md

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# API
2+
3+
!!!include(docs/pt/api/mount.md)!!!
4+
!!!include(docs/pt/api/shallowMount.md)!!!
5+
!!!include(docs/pt/api/render.md)!!!
6+
!!!include(docs/pt/api/renderToString.md)!!!
7+
!!!include(docs/pt/api/selectors.md)!!!
8+
!!!include(docs/pt/api/createLocalVue.md)!!!
9+
!!!include(docs/pt/api/createWrapper.md)!!!
10+
!!!include(docs/pt/api/config.md)!!!
11+
!!!include(docs/pt/api/enableAutoDestroy.md)!!!

Diff for: docs/pt/api/components/README.md

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

Diff for: docs/pt/api/components/RouterLinkStub.md

+20
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
## O componente RouterLinkStub
2+
3+
Um componente para forjar o componente `router-link` do Vue Router.
4+
5+
Você pode usar este componente para achar um componente `router-link` dentro da árvore de renderização.
6+
7+
- **Uso:**
8+
9+
Definir ele como um componente forjado dentro das opções de montagem:
10+
11+
```js
12+
import { mount, RouterLinkStub } from '@vue/test-utils'
13+
14+
const wrapper = mount(Component, {
15+
stubs: {
16+
RouterLink: RouterLinkStub
17+
}
18+
})
19+
expect(wrapper.findComponent(RouterLinkStub).props().to).toBe('/some/path')
20+
```

Diff for: docs/pt/api/config.md

+114
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
## Configuração
2+
3+
A Vue Test Utils incluem um objeto de configuração para as opções definidas usadas pela Vue Test Utils.
4+
5+
### Opções de Configuração da Vue Test Utils
6+
7+
### `showDeprecationWarnings`
8+
9+
- tipo: `Boolean`
10+
- valor padrão: `true`
11+
12+
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.
13+
14+
Exemplo:
15+
16+
```js
17+
import { config } from '@vue/test-utils'
18+
19+
config.showDeprecationWarnings = false
20+
```
21+
22+
### `deprecationWarningHandler`
23+
24+
- tipo: `Function`
25+
26+
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.
27+
28+
::: tip
29+
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
30+
:::
31+
32+
Exemplo:
33+
34+
```js
35+
import { config } from '@vue/test-utils'
36+
37+
config.showDeprecationWarnings = true
38+
config.deprecationWarningHandler = (method, message) => {
39+
if (method === 'emittedByOrder') return
40+
41+
console.error(message)
42+
}
43+
```
44+
45+
### `stubs`
46+
47+
- tipo: `{ [name: string]: Component | boolean | string }`
48+
- valor padrão: `{}`
49+
50+
O forjado guardado dentro de `config.stubs` é usado por padrão.
51+
Forjados para usar dentro de componentes. Estes são sobrescritos pelo `stubs` passado dentro das opções em montagem.
52+
53+
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>`.
54+
55+
Exemplo:
56+
57+
```js
58+
import { config } from '@vue/test-utils'
59+
60+
config.stubs['my-component'] = '<div />'
61+
```
62+
63+
### `mocks`
64+
65+
- tipo: `Object`
66+
- valor padrão: `{}`
67+
68+
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`.
69+
70+
Exemplo:
71+
72+
```js
73+
import { config } from '@vue/test-utils'
74+
75+
config.mocks['$store'] = {
76+
state: {
77+
id: 1
78+
}
79+
}
80+
```
81+
82+
### `methods`
83+
84+
- tipo: `{ [name: string]: Function }`
85+
- valor padrão: `{}`
86+
87+
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.
88+
89+
Exemplo:
90+
91+
```js
92+
import { config } from '@vue/test-utils'
93+
94+
config.methods['getData'] = () => {}
95+
```
96+
97+
### `provide`
98+
99+
- tipo: `Object`
100+
- valor padrão: `{}`
101+
102+
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`.**
103+
104+
Exemplo:
105+
106+
```js
107+
import { config } from '@vue/test-utils'
108+
109+
config.provide['$logger'] = {
110+
log: (...args) => {
111+
console.log(...args)
112+
}
113+
}
114+
```

Diff for: docs/pt/api/createLocalVue.md

+59
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
## O método createLocalVue()
2+
3+
- **Argumentos:**
4+
5+
- `{Object} options`
6+
- `{Function} errorHandler`
7+
8+
- **Retorna:**
9+
10+
- `{Component}`
11+
12+
- **Uso:**
13+
14+
O `createLocalVue` retorna uma classe do Vue para você adicionar componentes, mixins (combinadores) e instalar plugins sem poluir a classe global do Vue.
15+
16+
A opção `errorHandler` pode ser usada para manipular erros não capturados durante a função de renderizar do componente e observadores.
17+
18+
Use ele com `options.localVue`:
19+
20+
**Sem as opções:**
21+
22+
```js
23+
import { createLocalVue, shallowMount } from '@vue/test-utils'
24+
import MyPlugin from 'my-plugin'
25+
import Foo from './Foo.vue'
26+
27+
const localVue = createLocalVue()
28+
localVue.use(MyPlugin)
29+
const wrapper = shallowMount(Foo, {
30+
localVue,
31+
mocks: { foo: true }
32+
})
33+
expect(wrapper.vm.foo).toBe(true)
34+
35+
const freshWrapper = shallowMount(Foo)
36+
expect(freshWrapper.vm.foo).toBe(false)
37+
```
38+
39+
**Com a opção [`errorHandler`](https://vuejs.org/v2/api/#errorHandler):**
40+
41+
```js
42+
import { createLocalVue, shallowMount } from '@vue/test-utils'
43+
import Foo from './Foo.vue'
44+
45+
const errorHandler = (err, vm, info) => {
46+
expect(err).toBeInstanceOf(Error)
47+
}
48+
49+
const localVue = createLocalVue({
50+
errorHandler
51+
})
52+
53+
// Foo lança um erro dentro um gatilho do ciclo de vida
54+
const wrapper = shallowMount(Foo, {
55+
localVue
56+
})
57+
```
58+
59+
- **Consulte também:** [Dicas Comuns](../guides/common-tips.md#applying-global-plugins-and-mixins)

Diff for: docs/pt/api/createWrapper.md

+25
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
## O método createWrapper(node [, options])
2+
3+
- **Argumentos:**
4+
5+
- `{vm|HTMLElement} node`
6+
- `{Object} options`
7+
- `{Boolean} attachedToDocument`
8+
9+
- **Retorna:**
10+
11+
- `{Wrapper}`
12+
13+
- **Uso:**
14+
15+
O `createWrapper` cria um `Wrapper` para uma instância do Vue montada, ou um elemento HTML.
16+
17+
```js
18+
import { createWrapper } from '@vue/test-utils'
19+
import Foo from './Foo.vue'
20+
21+
const Constructor = Vue.extend(Foo)
22+
const vm = new Constructor().$mount()
23+
const wrapper = createWrapper(vm)
24+
expect(wrapper.vm.foo).toBe(true)
25+
```

0 commit comments

Comments
 (0)