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 <lachlan.miller.1990@outlook.com>

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)
+```