⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Vue Test Utils is a wrapper based API.
+`vue-test-utils` est une API basée sur un `wrapper`. -A `Wrapper` is an object that contains a mounted component or vnode and methods to test the component or vnode. +Un `Wrapper` est un objet qui contient un composant monté ou un nœud virtuel et des méthodes pour les tester. -- **Properties:** +- **Propriétés :** -`vm` `Component`: this is the `Vue` instance. You can access all the [instance methods and properties of a vm](https://vuejs.org/v2/api/#Instance-Properties) with `wrapper.vm`. This only exists on Vue component wrappers -`element` `HTMLElement`: the root DOM node of the wrapper -`options` `Object`: Object containing Vue Test Utils options passed to `mount` or `shallow` -`options.attachedToDom` `Boolean`: True if `attachToDom` was passed to `mount` or `shallow` +`vm` `Component`: c'est une instance de `Vue`. Vous pouvez accéder à toutes les [méthodes et propriétés de l'instance](https://vuejs.org/v2/api/#Instance-Properties) avec `wrapper.vm`. Cela existe uniquement sur les `wrappers` de composants Vue. +`element` `HTMLElement`: le nœud racine du DOM du `wrapper`. +`options` `Object`: objet contenant les options de `vue-test-utils` passées à `mount` ou `shallow`. +`options.attachedToDom` `Boolean`: `true` si `attachToDom` est passé à `mount` ou `shallow`. -- **Methods:** +- **Méthodes :** -There is a detailed list of methods in the wrapper section of the docs. +Il y a une liste détaillé des méthodes dans la section `wrapper` de la documentation. diff --git a/docs/en/api/wrapper/contains.md b/docs/en/api/wrapper/contains.md index d42c3f430..992ce9667 100644 --- a/docs/en/api/wrapper/contains.md +++ b/docs/en/api/wrapper/contains.md @@ -1,13 +1,13 @@ # `contains(selector)` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Assert `Wrapper` contains an element or component matching [selector](../selectors.md).
+Asserte que `Wrapper` contient un élément ou un composant correspondant au [sélecteur](../selectors.md). -- **Arguments:** - - `{string|Component} selector` +- **Paramètres :** + - `{string|Component} selector : un sélecteur` -- **Returns:** `{boolean}` +- **Retourne :** `{boolean}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' @@ -19,4 +19,4 @@ expect(wrapper.contains('p')).toBe(true) expect(wrapper.contains(Bar)).toBe(true) ``` -- **See also:** [selectors](../selectors.md) +- **Voir aussi :** [sélecteurs](../selectors.md) diff --git a/docs/en/api/wrapper/emitted.md b/docs/en/api/wrapper/emitted.md index 4a7710fa7..cffe8235d 100644 --- a/docs/en/api/wrapper/emitted.md +++ b/docs/en/api/wrapper/emitted.md @@ -1,10 +1,10 @@ # `emitted()` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Return an object containing custom events emitted by the `Wrapper` `vm`.
+Retourne un objet contenant des évènements émis par l'instance de Vue `vm` du `Wrapper`. -- **Returns:** `{ [name: string]: Array⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Return an Array containing custom events emitted by the `Wrapper` `vm`.
+Retourne un tableau contenant des évènements émis personnalisés par l'instance de Vue `vm` de `Wrapper`. -- **Returns:** `Array<{ name: string, args: Array⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Assert `Wrapper` or `WrapperArray` exists.
+Asserte que `Wrapper` ou `WrapperArray` existent. -Returns false if called on an empty `Wrapper` or `WrapperArray`. +Retourne `false` si appelé sur un `Wrapper` ou `WrapperArray` vide. -- **Returns:** `{boolean}` +- **Retourne :** `{boolean}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/find.md b/docs/en/api/wrapper/find.md index a233b2cf8..0a5ab5e33 100644 --- a/docs/en/api/wrapper/find.md +++ b/docs/en/api/wrapper/find.md @@ -1,15 +1,15 @@ # `find(selector)` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Returns [`Wrapper`](README.md) of first DOM node or Vue component matching selector.
+Retourne un [`Wrapper`](README.md) du premier nœud du DOM ou le composant Vue correspondant au sélecteur. -Use any valid [selector](../selectors.md). +Utilise n'importe quels [sélecteurs valides](../selectors.md). -- **Arguments:** - - `{string|Component} selector` +- **Paramètres ** + - `{string|Component} selector : un sélecteur` -- **Returns:** `{Wrapper}` +- **Retourne :** `{Wrapper}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' @@ -23,4 +23,4 @@ const bar = wrapper.find(Bar) expect(bar.is(Bar)).toBe(true) ``` -- **See also:** [Wrapper](README.md) +- **Voir aussi :** [Wrapper](README.md) diff --git a/docs/en/api/wrapper/findAll.md b/docs/en/api/wrapper/findAll.md index ad19f9137..35197224f 100644 --- a/docs/en/api/wrapper/findAll.md +++ b/docs/en/api/wrapper/findAll.md @@ -1,15 +1,15 @@ # `findAll(selector)` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Returns a [`WrapperArray`](../wrapper-array/README.md).
+Retourne un [`WrapperArray`](../wrapper-array/README.md) de [Wrappers](README.md). -Use any valid [selector](../selectors.md). +Utilise n'importe quels [sélecteurs valides](../selectors.md). -- **Arguments:** - - `{string|Component} selector` +- **Paramètres :** + - `{string|Component} selector : un sélecteur` -- **Returns:** `{WrapperArray}` +- **Retourne :** `{WrapperArray}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' @@ -23,4 +23,4 @@ const bar = wrapper.findAll(Bar).at(0) expect(bar.is(Bar)).toBe(true) ``` -- **See also:** [Wrapper](README.md) +- **Voir aussi :** [Wrapper](README.md) diff --git a/docs/en/api/wrapper/hasAttribute.md b/docs/en/api/wrapper/hasAttribute.md index 7022e8729..43da0b5c1 100644 --- a/docs/en/api/wrapper/hasAttribute.md +++ b/docs/en/api/wrapper/hasAttribute.md @@ -1,16 +1,16 @@ # hasAttribute(attribute, value) -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Assert `Wrapper` DOM node has attribute matching value.
+Asserte que le DOM du `Wrapper` a l'attribut avec la valeur correspondate. -Returns `true` if `Wrapper` DOM node contains attribute with matching value. +Retourne `true` si le nœud du DOM du `Wrapper` contient un attribut avec la bonne valeur. -- **Arguments:** +- **Paramètres :** - `{string} attribute` - `{string} value` -- **Returns:** `{boolean}` +- **Retourne :** `{boolean}` -- **Example:** +- **Exemple :** ```js import { mount } from 'vue-test-utils' @@ -21,9 +21,9 @@ const wrapper = mount(Foo) expect(wrapper.hasAttribute('id', 'foo')).toBe(true) ``` -- **Alternative:** +- **Alternative :** -You could get the attribute from the `Wrapper.element` to have a value based assertion: +Vous pouvez récuperer l'attribut depuis `Wrapper.element` pour avoir une assertion basée sur une valeur. ```js import { mount } from 'vue-test-utils' @@ -34,4 +34,4 @@ const wrapper = mount(Foo) expect(wrapper.element.getAttribute('id')).toBe('foo') ``` -This makes for a more informative assertion error. +Cela produit une erreur d'assertion plus informative. \ No newline at end of file diff --git a/docs/en/api/wrapper/hasClass.md b/docs/en/api/wrapper/hasClass.md index e236f49d5..98e3a12b2 100644 --- a/docs/en/api/wrapper/hasClass.md +++ b/docs/en/api/wrapper/hasClass.md @@ -1,15 +1,15 @@ # hasClass(className) -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Assert `Wrapper` DOM node has class contains `className`.
+Asserte que le DOM du `Wrapper` contient une classe nommé `className`. -Returns `true` if `Wrapper` DOM node contains the class. +Retourne `true` si le nœud du DOM du `Wrapper` contient la classe. -- **Arguments:** +- **Paramètres :** - `{string} className` -- **Returns:** `{boolean}` +- **Retourne :** `{boolean}` -- **Example:** +- **Exemple :** ```js import { mount } from 'vue-test-utils' diff --git a/docs/en/api/wrapper/hasProp.md b/docs/en/api/wrapper/hasProp.md index 8cc6ac567..c6661a9ca 100644 --- a/docs/en/api/wrapper/hasProp.md +++ b/docs/en/api/wrapper/hasProp.md @@ -1,19 +1,19 @@ # hasProp(prop, value) -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Assert `Wrapper` `vm` has `prop` matching `value`.
+Asserte que l'instance de Vue `vm` du `Wrapper` contient une `prop` de valeur `value`. -Returns `true` if `Wrapper` `vm` has `prop` matching `value`. +Retourne `true` si l'instance de Vue `vm` du `Wrapper` contient une `prop` de valeur `value`. -**Note: the Wrapper must contain a Vue instance.** +**Note : le Wrapper doit posséder une instance de Vue.** -- **Arguments:** +- **Paramètres :** - `{string} prop` - `{any} value` -- **Returns:** `{boolean}` +- **Retourne :** `{boolean}` -- **Example:** +- **Exemple :** ```js import { mount } from 'vue-test-utils' diff --git a/docs/en/api/wrapper/hasStyle.md b/docs/en/api/wrapper/hasStyle.md index ab150499f..4d5ffad17 100644 --- a/docs/en/api/wrapper/hasStyle.md +++ b/docs/en/api/wrapper/hasStyle.md @@ -1,18 +1,18 @@ # hasStyle(style, value) -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Assert `Wrapper` DOM node has style matching value.
+Asserte que le DOM du `Wrapper` contient un style avec une certaine valeur. -Returns `true` if `Wrapper` DOM node has `style` matching `value`. +Retourne `true` si le nœud du DOM du `Wrapper` contient un `style` correspondant à `value`. -**Note will only detect inline styles when running in `jsdom`.** +**Note : cela va uniquement détecter les styles `inlines` quand ils fonctionnent avec `jsdom`.** -- **Arguments:** +- **Paramètres :** - `{string} style` - `{string} value` -- **Returns:** `{boolean}` +- **Retourne :** `{boolean}` -- **Example:** +- **Exemple :** ```js import { mount } from 'vue-test-utils' diff --git a/docs/en/api/wrapper/html.md b/docs/en/api/wrapper/html.md index 678449ded..c91f76d40 100644 --- a/docs/en/api/wrapper/html.md +++ b/docs/en/api/wrapper/html.md @@ -1,10 +1,10 @@ # `html()` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Returns HTML of `Wrapper` DOM node as a string.
+Retourne l'HTML du DOM du `Wrapper` en string. -- **Returns:** `{string}` +- **Retourne :** `{string}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/is.md b/docs/en/api/wrapper/is.md index 1d892edd5..e5b2eac81 100644 --- a/docs/en/api/wrapper/is.md +++ b/docs/en/api/wrapper/is.md @@ -1,13 +1,13 @@ # `is(selector)` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Assert `Wrapper` DOM node or `vm` matches [selector](../selectors.md).
+Asserte que le DOM du `Wrapper` ou que l'instance de Vue `vm` correspond au [sélecteur](../selectors.md). -- **Arguments:** - - `{string|Component} selector` +- **Paramètres :** + - `{string|Component} selector : un sélecteur` -- **Returns:** `{boolean}` +- **Retourne :** `{boolean}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/isEmpty.md b/docs/en/api/wrapper/isEmpty.md index dceb65e5e..b4eb13115 100644 --- a/docs/en/api/wrapper/isEmpty.md +++ b/docs/en/api/wrapper/isEmpty.md @@ -1,10 +1,10 @@ # `isEmpty()` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Assert `Wrapper` does not contain child node.
+Asserte que le `Wrapper` ne contient pas de nœuds enfants. -- **Returns:** `{boolean}` +- **Retourne :** `{boolean}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/isVueInstance.md b/docs/en/api/wrapper/isVueInstance.md index 8bcf22687..538507f15 100644 --- a/docs/en/api/wrapper/isVueInstance.md +++ b/docs/en/api/wrapper/isVueInstance.md @@ -1,10 +1,10 @@ # `isVueInstance()` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Assert `Wrapper` is Vue instance.
+Asserte que `Wrapper` contient une instance de Vue. -- **Returns:** `{boolean}` +- **Retourne :** `{boolean}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/name.md b/docs/en/api/wrapper/name.md index 5592d36fe..f38f520be 100644 --- a/docs/en/api/wrapper/name.md +++ b/docs/en/api/wrapper/name.md @@ -1,10 +1,10 @@ # `name()` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Returns component name if `Wrapper` contains a Vue instance, or the tag name of `Wrapper` DOM node if `Wrapper` does not contain a Vue instance.
+Retourne le nom du composant si le `Wrapper` contient une instance de Vue. Il retourne le nom de la balise du nœud du DOM du `Wrapper` s'il ne contient pas une instance de Vue. -- **Returns:** `{string}` +- **Retourne :** `{string}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/setData.md b/docs/en/api/wrapper/setData.md index af1cfa65f..74fef9d17 100644 --- a/docs/en/api/wrapper/setData.md +++ b/docs/en/api/wrapper/setData.md @@ -1,13 +1,13 @@ # `setData(data)` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Sets `Wrapper` `vm` data and forces update.
+Assigne les données de l'instance de Vue `vm` du `Wrapper` `vm` et force la mise à jour. -**Note the Wrapper must contain a Vue instance.** +**Note : le `Wrapper` doit contenir une instance de Vue.** -- **Arguments:** - - `{Object} data` +- **Paramètres :** + - `{Object} data : données` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/setMethods.md b/docs/en/api/wrapper/setMethods.md index dd0e9db82..cc48b0872 100644 --- a/docs/en/api/wrapper/setMethods.md +++ b/docs/en/api/wrapper/setMethods.md @@ -1,13 +1,13 @@ # `setMethods(methods)` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Sets `Wrapper` `vm` methods and forces update.
+Assigne les méthodes de l'instance de Vue `vm` du `Wrapper` `vm` et force la mise à jour. -**Note the Wrapper must contain a Vue instance.** +**Note : le `Wrapper` doit contenir une instance de Vue.** -- **Arguments:** +- **Paramètres:** - `{Object} methods` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/setProps.md b/docs/en/api/wrapper/setProps.md index 4b05ea4ae..154faf342 100644 --- a/docs/en/api/wrapper/setProps.md +++ b/docs/en/api/wrapper/setProps.md @@ -1,13 +1,13 @@ # `setProps(props)` -- **Arguments:** +- **Paramètres :** - `{Object} props` -- **Usage:** +- **Exemple :** -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Sets `Wrapper` `vm` props and forces update.
+Assigne les `props` de l'instance de Vue `vm` du `Wrapper` `vm` et force la mise à jour. -**Note the Wrapper must contain a Vue instance.** +**Note : le `Wrapper` doit contenir une instance de Vue.** ```js import { mount } from '@vue/test-utils' @@ -18,7 +18,7 @@ wrapper.setProps({ foo: 'bar' }) expect(wrapper.vm.foo).toBe('bar') ``` -You can also pass a `propsData` object, which will initialize the Vue instance with passed values. +Vous pouvez aussi passer un objet `propsData`, qui initialisera l'instance de Vue avec des données. ``` js // Foo.vue diff --git a/docs/en/api/wrapper/text.md b/docs/en/api/wrapper/text.md index a47ca81f7..5d46cecef 100644 --- a/docs/en/api/wrapper/text.md +++ b/docs/en/api/wrapper/text.md @@ -1,10 +1,10 @@ # `text()` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Returns text content of `Wrapper`.
+Retourne le contenu texte du `Wrapper`. -- **Returns:** `{string}` +- **Retourne :** `{string}` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/trigger.md b/docs/en/api/wrapper/trigger.md index 325451fcd..589d776c7 100644 --- a/docs/en/api/wrapper/trigger.md +++ b/docs/en/api/wrapper/trigger.md @@ -1,14 +1,14 @@ # `trigger(eventName)` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Triggers an event on the `Wrapper` DOM node.
+Déclenche un évènement sur le nœud du DOM du `Wrapper`. -`trigger` takes an optional `options` object. The properties in the `options` object are added to the Event. +`Trigger` prend un objet optionel `options`. Les propriétés dans `options` sont ajoutées à l'évènement. -- **Arguments:** - - `{string} eventName` +- **Paramètres :** + - `{string} eventName : nom de l'évènement` - `{Object} options` -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' diff --git a/docs/en/api/wrapper/update.md b/docs/en/api/wrapper/update.md index 97fc85391..f59dcb2c4 100644 --- a/docs/en/api/wrapper/update.md +++ b/docs/en/api/wrapper/update.md @@ -1,10 +1,10 @@ # `update()` -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Force root Vue component to re-render.
+Force le composant racine de Vue à se mettre à jour. -If called on a `Wrapper` containing a `vm`, it will force the `Wrapper` `vm` to re-render. +Si appelée sur un `Wrapper` contenant une instance de Vue `vm`, cela forcera le `Wrapper` à la re-rendre. -- **Example:** +- **Exemple :** ```js import { mount } from '@vue/test-utils' @@ -12,7 +12,7 @@ import Foo from './Foo.vue' const wrapper = mount(Foo) expect(wrapper.vm.bar).toBe('bar') -wrapper.vm.bar = 'new value' +wrapper.vm.bar = 'nouvelle valeur' wrapper.update() -expect(wrapper.vm.bar).toBe('new value') +expect(wrapper.vm.bar).toBe('nouvelle valeur') ```