docs: Add french Version (#1837)

* add french version

* add more

* update of the french version in relation to the feedback

* docs: fix some errors in linting docs

* fixed the sidebar and updated the README files in the Wrapper and Installation folders

* update with prettier run

Co-authored-by: Lachlan Miller <[email protected]>

Author: phrobinet

docs/.vuepress/config.js

@@ -19,6 +19,11 @@ module.exports = {
       lang: 'ru',
       title: 'Vue Test Utils',
       description: 'Библиотека для тестирования Vue-компонентов'
+    },
+    '/fr/': {
+      title: 'Vue Test Utils',
+      lang: 'fr',
+      description: 'Utilitaires pour tester les composants Vue'
     }
   },
   plugins: ['@vuepress/pwa'],
@@ -167,6 +172,38 @@ module.exports = {
           '/ru/api/options',
           '/ru/api/components/'
         ]
+      },
+      '/fr/': {
+        label: 'Français',
+        selectText: 'langue',
+        editLinkText: 'Modifier cette page sur GitHub',
+        nav: [
+          {
+            text: 'API',
+            link: '/fr/api/'
+          },
+          {
+            text: 'Guides',
+            link: '/fr/guides/',
+            items: [
+              {
+                text: '2.x-beta',
+                link:
+                  'https://vuejs.github.io/vue-test-utils-next-docs/guide/introduction.html'
+              }
+            ]
+          }
+        ],
+        sidebar: [
+          '/fr/',
+          '/fr/installation/',
+          '/fr/guides/',
+          '/fr/api/',
+          '/fr/api/wrapper/',
+          '/fr/api/wrapper-array/',
+          '/fr/api/options',
+          '/fr/api/components/'
+        ]
       }
     }
   },

docs/fr/README.md

@@ -0,0 +1,90 @@
+# Introduction
+
+Vue Test Utils est la bibliothèque officielle de tests unitaires pour Vue.js.
+
+Voici la documentation de Vue Test Utils v1, qui vise Vue 2 et les versions antérieures.
+
+En bref :
+
+- [Vue Test Utils 1](https://github.com/vuejs/vue-test-utils/) ciblant [Vue 2](https://github.com/vuejs/vue/).
+- [Vue Test Utils 2](https://github.com/vuejs/vue-test-utils-next/) ciblant [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="Learn how to use Vue Test Utils to test Vue.js Components with Vue School">Apprenez comment tester les composants de Vue.js avec Vue School</a></div>
+
+- [Installation](./installation/)
+- [Guides](./guides/)
+  - [Pour commencer](./guides/getting-started.md)
+  - [Les Conseils pratiques](guides/common-tips.md)
+  - [Test des touches, de la souris et d'autres événements DOM](guides/dom-events.md)
+  - [Tester le comportement asynchrone](guides/testing-async-components.md)
+  - [Utilisation avec TypeScript](guides/using-with-typescript.md)
+  - [Utilisation avec Vue Router](guides/using-with-vue-router.md)
+  - [Utilisation avec Vuex](guides/using-with-vuex.md)
+  - [Bibliothèques utiles pour les tests](guides/useful-libraries-for-testing.md)
+- [API](api/)
+  - [mount](api/mount.md)
+  - [shallowMount](api/shallowMount.md)
+  - [render](api/render.md)
+  - [renderToString](api/renderToString.md)
+  - [Mounting Options](api/options.md)
+    - [context](api/options.md#context)
+    - [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)
+    - [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#other-options)
+  - [Wrapper](api/wrapper/)
+    - [attributes](api/wrapper/attributes.md)
+    - [classes](api/wrapper/classes.md)
+    - [contains](api/wrapper/contains.md)
+    - [emitted](api/wrapper/emitted.md)
+    - [emittedByOrder](api/wrapper/emittedByOrder.md)
+    - [exists](api/wrapper/exists.md)
+    - [destroy](api/wrapper/destroy.md)
+    - [find](api/wrapper/find.md)
+    - [findAll](api/wrapper/findAll.md)
+    - [get](api/wrapper/get.md)
+    - [html](api/wrapper/html.md)
+    - [is](api/wrapper/is.md)
+    - [isEmpty](api/wrapper/isEmpty.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)
+    - [isVisible](api/wrapper/isVisible.md)
+  - [WrapperArray](api/wrapper-array/)
+    - [at](api/wrapper-array/at.md)
+    - [contains](api/wrapper-array/contains.md)
+    - [exists](api/wrapper/exists.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)
+    - [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)
+    - [isVisible](api/wrapper-array/isVisible.md)
+  - [components](api/components/)
+    - [RouterLinkStub](api/components/RouterLinkStub.md)
+  - [Selectors](api/selectors.md)
+  - [createWrapper](api/createWrapper.md)
+  - [createLocalVue](api/createLocalVue.md)
+  - [config](api/config.md)

docs/fr/api/README.md

@@ -0,0 +1,11 @@
+# API
+
+!!!include(docs/fr/api/mount.md)!!!
+!!!include(docs/fr/api/shallowMount.md)!!!
+!!!include(docs/fr/api/render.md)!!!
+!!!include(docs/fr/api/renderToString.md)!!!
+!!!include(docs/fr/api/selectors.md)!!!
+!!!include(docs/fr/api/createLocalVue.md)!!!
+!!!include(docs/fr/api/createWrapper.md)!!!
+!!!include(docs/fr/api/config.md)!!!
+!!!include(docs/fr/api/enableAutoDestroy.md)!!!

docs/fr/api/components/README.md

@@ -0,0 +1,4 @@
+# Components
+
+Vue Test Utils comprend des composants utilitaires que vous pouvez utiliser pour avoir des composants de remplacement (stubs).
+!!!include(docs/fr/api/components/RouterLinkStub.md)!!!

docs/fr/api/components/RouterLinkStub.md

@@ -0,0 +1,20 @@
+## RouterLinkStub
+
+Un composant pour mettre en place le composant Vue Router `router-link`.
+
+Vous pouvez utiliser ce composant pour trouver un composant router-link dans l'arbre de rendu.
+
+- **Usage:**
+
+Pour le définir comme un stub dans les options de montage :
+
+```js
+import { mount, RouterLinkStub } from '@vue/test-utils'
+
+const wrapper = mount(Component, {
+  stubs: {
+    RouterLink: RouterLinkStub
+  }
+})
+expect(wrapper.find(RouterLinkStub).props().to).toBe('/some/path')
+```

docs/fr/api/config.md

@@ -0,0 +1,114 @@
+## Config
+
+Vue Test Utils comprend un objet de configuration des options définies utilisées par Vue Test Utils.
+
+### Vue Test Utils Config Options
+
+### `showDeprecationWarnings`
+
+- type: `Boolean`
+- default: `true`
+
+Contrôler s'il faut ou non afficher des avertissements de dépréciation . Lorsqu'il est sur `true`, tous les avertissements de dépréciation sont visibles dans la console.
+
+Exemple:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.showDeprecationWarnings = false
+```
+
+### `deprecationWarningHandler`
+
+- type: `Function`
+
+Permet un contrôle fin des avertissements de dépréciation. Lorsque `showDeprecationWarnings` est défini à `true`, tous les avertissements de dépréciation seront passés à ce gestionnaire avec le nom de la méthode comme premier argument et le message original comme second.
+
+::: tip
+Cela peut être utile pour enregistrer les messages de dépréciation à un endroit séparé ou pour aider à la mise à jour progressive de la base de code vers la dernière version de test utils en ignorant certains avertissements de fonctions dépréciées.
+:::
+
+Example:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.showDeprecationWarnings = true
+config.deprecationWarningHandler = (method, message) => {
+  if (method === 'emittedByOrder') return
+
+  console.error(msg)
+}
+```
+
+### `stubs`
+
+- type: `{ [name: string]: Component | boolean | string }`
+- default: `{}`
+
+Le stub stocké dans `config.stubs` est utilisé par défaut.
+Les stubs sont à utiliser dans les composants. Ils sont écrasés par les `stubs` passés dans les options de montage.
+
+Lorsque l'on passe des `stubs` sous forme de tableau dans les options de montage, les `config.stubs` sont convertis en un tableau, et vont stuber les composants avec un composant de base qui retourne `<${component name}-stub>`.
+
+Exemple:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.stubs['my-component'] = '<div />'
+```
+
+### `mocks`
+
+- type: `Object`
+- default: `{}`
+
+Comme pour les `stubs`, les valeurs passées à `config.mocks` sont utilisées par défaut. Toute valeur passée à l'objet d'options de montage `mocks` aura la priorité sur celles déclarées dans `config.mocks`.
+
+Exemple:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.mocks['$store'] = {
+  state: {
+    id: 1
+  }
+}
+```
+
+### `methods`
+
+- type: `{ [name: string]: Function }`
+- default: `{}`
+
+Vous pouvez configurer les méthodes par défaut en utilisant l'objet `config`. Cela peut être utile pour les plugins qui injectent des méthodes aux composants, comme [VeeValidate](https://logaretm.github.io/vee-validate/). Vous pouvez surcharger les méthodes définies dans `config` en passant des `méthodes` dans les options de montage.
+
+Exemple:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.methods['getData'] = () => {}
+```
+
+### `provide`
+
+- type: `Object`
+- default: `{}`
+
+Comme les `stubs` ou `mocks`, les valeurs passées à "config.provide" sont utilisées par défaut. Toutes les valeurs passées à l'objet d'options de montage `provide` auront la priorité sur celles déclarées dans `config.provide`. **Veuillez noter qu'il n'est pas possible de passer une fonction comme `config.provide`.**
+
+Exemple:
+
+```js
+import { config } from '@vue/test-utils'
+
+config.provide['$logger'] = {
+  log: (...args) => {
+    console.log(...args)
+  }
+}
+```

docs/fr/api/createLocalVue.md

@@ -0,0 +1,59 @@
+## createLocalVue()
+
+- **Arguments:**
+
+  - `{Object} options`
+    - `{Function} errorHandler`
+
+- **Retours:**
+
+  - `{Component}`
+
+- **Usage:**
+
+`createLocalVue` renvoie une classe Vue pour que vous puissiez ajouter des composants, des mixins et installer des plugins sans polluer la classe Vue globale.
+
+L'option `errorHandler` peut être utilisée pour gérer les erreurs non attrapées pendant la fonction de rendu du composant et les observateurs.
+
+Utilisez-la avec `options.localVue`:
+
+**Sans les options:**
+
+```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)
+```
+
+**Avec l'option [`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 lance une erreur à l'intérieur d'un crochet de cycle de vie
+const wrapper = shallowMount(Foo, {
+  localVue
+})
+```
+
+- **Voir aussi:** [Common Tips](../guides/common-tips.md#applying-global-plugins-and-mixins)

docs/fr/api/createWrapper.md

@@ -0,0 +1,25 @@
+## createWrapper(node [, options])
+
+- **Arguments:**
+
+  - `{vm|HTMLElement} node`
+  - `{Object} options`
+    - `{Boolean} attachedToDocument`
+
+- **Retours:**
+
+  - `{Wrapper}`
+
+- **Usage:**
+
+`createWrapper` crée un `Wrapper` pour une instance Vue montée, ou un élément 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)
+```