Skip to content

Commit 4d900e0

Browse files
YatyMachinisteWeb
authored andcommitted
Guide: using-with-vuex.md (#7)
* using-with-vuex.md: traduction, première itération * corrections * corrections * corrections
1 parent 2339ccb commit 4d900e0

File tree

1 file changed

+37
-38
lines changed

1 file changed

+37
-38
lines changed

Diff for: docs/en/guides/using-with-vuex.md

+37-38
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
# Using with Vuex
1+
# Utiliser avec Vuex
22

3-
In this guide, we'll see how to test Vuex in components with `vue-test-utils`.
3+
Dans ce guide, nous allons voir comment tester Vuex dans des composants grâce à `vue-test-utils`.
44

5-
## Mocking Actions
5+
## Simuler des actions
66

7-
Let’s look at some code.
7+
Regardons un peu de code !
88

9-
This is the component we want to test. It calls Vuex actions.
9+
Ci-dessous, le composant que nous voulons tester. Il fait appel à des actions Vuex.
1010

1111
``` html
1212
<template>
@@ -35,13 +35,13 @@ export default{
3535
</script>
3636
```
3737

38-
For the purposes of this test, we don’t care what the actions do, or what the store looks like. We just need to know that these actions are being fired when they should, and that they are fired with the expected value.
38+
Pour les objectifs de ce test, on se fiche de ce que les actions font, ou à ce quoi le store ressemble. On doit juste savoir si ces actions sont lancées lorsqu'elles sont supposées l'être, et ce, avec les valeurs attendues.
3939

40-
To test this, we need to pass a mock store to Vue when we shallow our component.
40+
Pour tester cela, on doit passer un store fictif à Vue lorsque l'on isole notre composant.
4141

42-
Instead of passing the store to the base Vue constructor, we can pass it to a - [localVue](../api/options.md#localvue). A localVue is a scoped Vue constructor that we can make changes to without affecting the global Vue constructor.
42+
Au lieu de passer le store au constructeur de base de Vue, on peut le passer à - [`localVue`](../api/options.md#localvue). Un `localVue` est un constructeur à portée limitée de Vue sur lequel on peut effectuer des changements sans avoir à affecter le constructeur global.
4343

44-
Let’s see what this looks like:
44+
Voyons à quoi cela ressemble :
4545

4646
``` js
4747
import { shallow, createLocalVue } from 'vue-test-utils'
@@ -67,47 +67,47 @@ describe('Actions.vue', () => {
6767
})
6868
})
6969

70-
it('calls store action actionInput when input value is input and an input event is fired', () => {
70+
it("appelle l'action `actionInput` du store quand la valeur du champ est `input` et qu'un évènement `input` est lancé", () => {
7171
const wrapper = shallow(Actions, { store, localVue })
7272
const input = wrapper.find('input')
7373
input.element.value = 'input'
7474
input.trigger('input')
7575
expect(actions.actionInput).toHaveBeenCalled()
7676
})
7777

78-
it('does not call store action actionInput when input value is not input and an input event is fired', () => {
78+
it("n'appelle pas l'action `actionInput` du store quand la valeur du champ n'est pas `input` et qu'un évènement `input` est lancé", () => {
7979
const wrapper = shallow(Actions, { store, localVue })
8080
const input = wrapper.find('input')
8181
input.element.value = 'not input'
8282
input.trigger('input')
8383
expect(actions.actionInput).not.toHaveBeenCalled()
8484
})
8585

86-
it('calls store action actionClick when button is clicked', () => {
86+
it("appelle l'action `actionClick` quand le bouton est cliqué", () => {
8787
const wrapper = shallow(Actions, { store, localVue })
8888
wrapper.find('button').trigger('click')
8989
expect(actions.actionClick).toHaveBeenCalled()
9090
})
9191
})
9292
```
9393

94-
What’s happening here? First we tell Vue to use Vuex with the `Vue.use` method. This is just a wrapper around `Vue.use`.
94+
Que se passe-t-il ici ? Premièrement, on indique à Vue d'utiliser Vuex avec la méthode `use`. C'est tout simplement une surcouche de `Vue.use`.
9595

96-
We then make a mock store by calling new `Vuex.store` with our mock values. We only pass it the actions, since that’s all we care about.
96+
On va ensuite créer un store fictif en appelant `new Vuex.Store` avec nos propres valeurs. À noter que l'on indique uniquement nos actions, car on ne s'intéresse qu'à elles.
9797

98-
The actions are [jest mock functions](https://facebook.github.io/jest/docs/en/mock-functions.html). These mock functions give us methods to assert whether the actions were called or not.
98+
Les actions sont des [fonctions de simulations de Jest](https://facebook.github.io/jest/docs/en/mock-functions.html). Ces fonctions nous donnent accès à des méthodes afin de réaliser des assertions si l'action a été appelée ou non.
9999

100-
We can then assert in our tests that the action stub was called when expected.
100+
On peut ensuite s'assurer dans nos tests que les actions ont été appelées au bon moment.
101101

102-
Now the way we define the store might look a bit foreign to you.
102+
La manière dont on définit le store peut vous paraitre un peu étrange.
103103

104-
We’re using `beforeEach` to ensure we have a clean store before each test. `beforeEach` is a mocha hook that’s called before each test. In our test, we are reassigning the store variables value. If we didn’t do this, the mock functions would need to be automatically reset. It also lets us change the state in our tests, without it affecting later tests.
104+
On utilise `beforeEach` pour s'assurer que nous avons un store propre avant chaque test. `beforeEach` est un hook de Mocha qui est appelé avant chaque test. Dans nos tests, on réassigne des valeurs aux variables du store. Si on ne le fait pas, les fonctions de simulations auraient besoin d'être automatiquement réinitialisées. Cela nous laisse la possibilité de changer l'état dans nos tests, sans avoir à affecter les prochains.
105105

106-
The most important thing to note in this test is that **we create a mock Vuex store and then pass it to vue-test-utils**.
106+
La chose la plus importante à noter dans ce test est que **l'on crée une simulation d'un store Vuex, qui est ensuite passé à vue-test-utils**.
107107

108-
Great, so now we can mock actions, let’s look at mocking getters.
108+
Génial, on peut désormais simuler des actions. Allons avoir comment simuler des accesseurs !
109109

110-
## Mocking Getters
110+
## Simuler des accesseurs
111111

112112

113113
``` html
@@ -130,9 +130,9 @@ export default{
130130
</script>
131131
```
132132

133-
This is a fairly simple component. It renders the result of the getters `clicks` and `inputValue`. Again, we don’t really care about what those getters returns – just that the result of them is being rendered correctly.
133+
C'est un composant relativement simple. Il affiche le résultat des accesseurs `clicks` et `inputValue`. Encore une fois, on se fiche de savoir ce que ces accesseurs retournent. On souhaite juste savoir si les résultats sont affichés correctement.
134134

135-
Let’s see the test:
135+
Jetons un œil à un test :
136136

137137
``` js
138138
import { shallow, createLocalVue } from 'vue-test-utils'
@@ -158,33 +158,33 @@ describe('Getters.vue', () => {
158158
})
159159
})
160160

161-
it('Renders state.inputValue in first p tag', () => {
161+
it('affiche `state.inputValue` dans la première balise <p>', () => {
162162
const wrapper = shallow(Actions, { store, localVue })
163163
const p = wrapper.find('p')
164164
expect(p.text()).toBe(getters.inputValue())
165165
})
166166

167-
it('Renders state.clicks in second p tag', () => {
167+
it('affiche `stat.clicks` dans la seconde balise <p>', () => {
168168
const wrapper = shallow(Actions, { store, localVue })
169169
const p = wrapper.findAll('p').at(1)
170170
expect(p.text()).toBe(getters.clicks().toString())
171171
})
172172
})
173173
```
174-
This test is similar to our actions test. We create a mock store before each test, pass it as an option when we call `shallow`, and assert that the value returned by our mock getters is being rendered.
174+
Ce test est similaire à notre test sur les actions. On créer un store fictif avant chaque test, on le passe ensuite comme une option lorsque l'on appelle `shallow`. Pour finir, on asserte que la valeur retournée par nos accesseurs fictifs est bien affichée.
175175

176-
This is great, but what if we want to check our getters are returning the correct part of our state?
176+
C'est génial, mais comment faisons-nous pour vérifier que nos accesseurs retournent correctement les parties de l'état ?
177177

178-
## Mocking with Modules
178+
## Simulation avec des modules
179179

180-
[Modules](https://vuex.vuejs.org/en/modules.html) are useful for separating out our store into manageable chunks. They also export getters. We can use these in our tests.
180+
Les [modules](https://vuex.vuejs.org/en/modules.html) sont utiles pour séparer un store en plusieurs morceaux. Ils exportent des accesseurs que l'on peut utiliser dans nos tests.
181181

182-
Let’s look at our component:
182+
Jetons un œil à ce composant :
183183

184184
``` html
185185
<template>
186186
<div>
187-
<button @click="moduleActionClick()">Click</button>
187+
<button @click="moduleActionClick()">Cliquer</button>
188188
<p>{{moduleClicks}}</p>
189189
</div>
190190
</template>
@@ -205,9 +205,8 @@ export default{
205205
}
206206
</script>
207207
```
208-
Simple component that includes one action and one getter.
209-
210-
And the test:
208+
Simple composant qui possède une action et un accesseur.
209+
Et le test :
211210

212211
``` js
213212
import { shallow, createLocalVue } from 'vue-test-utils'
@@ -242,23 +241,23 @@ describe('Modules.vue', () => {
242241
})
243242
})
244243

245-
it('calls store action moduleActionClick when button is clicked', () => {
244+
it("appelle l'action du store moduleActionClick quand le bouton est cliqué", () => {
246245
const wrapper = shallow(Modules, { store, localVue })
247246
const button = wrapper.find('button')
248247
button.trigger('click')
249248
expect(actions.moduleActionClick).toHaveBeenCalled()
250249
})
251250

252-
it('Renders state.inputValue in first p tag', () => {
251+
it("affiche `state.inputValue` dans la première balise <p>", () => {
253252
const wrapper = shallow(Modules, { store, localVue })
254253
const p = wrapper.find('p')
255254
expect(p.text()).toBe(state.module.clicks.toString())
256255
})
257256
})
258257
```
259258

260-
### Resources
259+
### Ressources
261260

262-
- [Example project for this guide](https://github.com/eddyerburgh/vue-test-utils-vuex-example)
261+
- [Projet exemple pour ce guide](https://github.com/eddyerburgh/vue-test-utils-vuex-example)
263262
- [localVue](../api/options.md#localvue)
264263
- [createLocalVue](../api/createLocalVue.md)

0 commit comments

Comments
 (0)