.circleci/config.yml

@@ -60,13 +60,6 @@ jobs:
       - run:
           name: yarn test
           command: yarn test
-  test_compat:
-    <<: *defaults
-    steps:
-      - attach_workspace:
-          at: ~/repo
-      - *restore_node_modules
-      - run: yarn test:compat
 workflows:
   version: 2
   install-tests:
@@ -81,8 +74,3 @@ workflows:
       - test:
           requires:
             - install
-      - test_compat:
-          requires:
-            - install
-            - build_test
-            - test

.eslintignore

@@ -1 +1 @@
-dist
+**/dist/**

.gitignore

@@ -1,5 +1,6 @@
 .DS_Store
 node_modules/
+.eslintcache
 
 # Editor files
 /.idea

.nvmrc

@@ -1 +1 @@
-v10
+v16

.prettierrc.json

@@ -1,4 +1,6 @@
 {
   "semi": false,
-  "singleQuote": true
+  "singleQuote": true,
+  "trailingComma": "none",
+  "arrowParens": "avoid"
 }

README.md

@@ -1,6 +1,6 @@
 # Vue Test Utils [![Build Status](https://circleci.com/gh/vuejs/vue-test-utils/tree/dev.png?style=shield)](https://circleci.com/gh/vuejs/vue-test-utils)
 
-Vue Test Utils is the official testing library for Vue.js.
+Component testing utils for Vue 2.
 
 ## Packages
 
@@ -12,8 +12,8 @@ This repository provides the following two packages:
 You can install these packages by the following command.
 
 ```
-npm install --save-dev @vue/test-utils
-npm install --save-dev @vue/server-test-utils
+npm install --save-dev @vue/test-utils@1
+npm install --save-dev @vue/server-test-utils@1
 ```
 
 ## Peer Dependencies
@@ -26,15 +26,15 @@ npm install --save-dev vue-template-compiler
 
 ## Documentation
 
-Refer to the [documentation](https://vue-test-utils.vuejs.org/)
+Refer to the [documentation](https://v1.test-utils.vuejs.org/)
 
 ## Questions
 
 For questions and support please use the [Discord chat room](https://vue-land.js.org/) or [the official forum](http://forum.vuejs.org). The issue list of this repo is **exclusively** for bug reports and feature requests.
 
 ## Issues
 
-Please make sure to read the [Issue Reporting Checklist](https://github.com/vuejs/vue/blob/dev/.github/CONTRIBUTING.md#issue-reporting-guidelines) before opening an issue. Issues not conforming to the guidelines may be closed immediately.
+Please make sure to read the issue reporting requirements before opening an issue. Issues not conforming to the guidelines may be closed immediately.
 
 ## Contribution
 

docs/.vuepress/config.js

@@ -24,6 +24,11 @@ module.exports = {
       title: 'Vue Test Utils',
       lang: 'fr',
       description: 'Utilitaires pour tester les composants Vue'
+    },
+    '/pt/': {
+      title: 'Vue Test Utils',
+      lang: 'pt',
+      description: 'Utilitários para testes de componentes de Vue'
     }
   },
   plugins: ['@vuepress/pwa'],
@@ -59,8 +64,8 @@ module.exports = {
             link: '/guides/',
             items: [
               {
-                text: '2.x-beta',
-                link: 'https://next.vue-test-utils.vuejs.org/guide/'
+                text: 'v2 (Vue.js 3)',
+                link: 'https://test-utils.vuejs.org/'
               }
             ]
           },
@@ -94,8 +99,8 @@ module.exports = {
             link: '/zh/guides/',
             items: [
               {
-                text: '2.x-beta',
-                link: 'https://next.vue-test-utils.vuejs.org/guide/'
+                text: 'v2 (Vue.js 3)',
+                link: 'https://test-utils.vuejs.org/'
               }
             ]
           }
@@ -125,8 +130,8 @@ module.exports = {
             link: '/ja/guides/',
             items: [
               {
-                text: '2.x-beta',
-                link: 'https://next.vue-test-utils.vuejs.org/guide/'
+                text: 'v2 (Vue.js 3)',
+                link: 'https://test-utils.vuejs.org/'
               }
             ]
           }
@@ -156,8 +161,8 @@ module.exports = {
             link: '/ru/guides/',
             items: [
               {
-                text: '2.x-beta',
-                link: 'https://next.vue-test-utils.vuejs.org/guide/'
+                text: 'v2 (Vue.js 3)',
+                link: 'https://test-utils.vuejs.org/'
               }
             ]
           }
@@ -187,9 +192,8 @@ module.exports = {
             link: '/fr/guides/',
             items: [
               {
-                text: '2.x-beta',
-                link:
-                  'https://vuejs.github.io/vue-test-utils-next-docs/guide/introduction.html'
+                text: 'v2 (Vue.js 3)',
+                link: 'https://test-utils.vuejs.org/'
               }
             ]
           }
@@ -204,6 +208,41 @@ module.exports = {
           '/fr/api/options',
           '/fr/api/components/'
         ]
+      },
+      '/pt/': {
+        label: 'Português',
+        selectText: 'Idiomas',
+        editLinkText: 'Edite esta página no GitHub',
+        nav: [
+          {
+            text: 'API',
+            link: '/pt/api/'
+          },
+          {
+            text: 'Guias',
+            link: '/pt/guides/',
+            items: [
+              {
+                text: '2.x-beta',
+                link: 'https://next.vue-test-utils.vuejs.org/guide/'
+              }
+            ]
+          },
+          {
+            text: 'Atualizando para V1',
+            link: '/pt/upgrading-to-v1/'
+          }
+        ],
+        sidebar: [
+          '/pt/',
+          '/pt/installation/',
+          '/pt/guides/',
+          '/pt/api/',
+          '/pt/api/wrapper/',
+          '/pt/api/wrapper-array/',
+          '/pt/api/options',
+          '/pt/api/components/'
+        ]
       }
     }
   },

docs/.vuepress/theme/Layout.vue

@@ -9,10 +9,7 @@
           </p>
           <p>
             To read docs for Vue Test Utils for Vue 3,
-            <a
-              href="https://next.vue-test-utils.vuejs.org/guide/"
-              v-text="'click here'"
-            />.
+            <a href="https://test-utils.vuejs.org/" v-text="'click here'" />.
           </p>
         </div>
       </div>

docs/README.md

@@ -7,7 +7,7 @@ This is the documentation for Vue Test Utils v1, which targets Vue 2 and earlier
 In short:
 
 - [Vue Test Utils 1](https://github.com/vuejs/vue-test-utils/) targets [Vue 2](https://github.com/vuejs/vue/).
-- [Vue Test Utils 2](https://github.com/vuejs/vue-test-utils-next/) targets [Vue 3](https://github.com/vuejs/vue-next/).
+- [Vue Test Utils 2](https://github.com/vuejs/test-utils) targets [Vue 3](https://github.com/vuejs/core).
 
 <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">Learn how to test Vue.js components with Vue School</a></div>
 

docs/api/options.md

@@ -169,7 +169,7 @@ You can also pass a function that takes the props as an argument:
 ```js
 shallowMount(Component, {
   scopedSlots: {
-    foo: function(props) {
+    foo: function (props) {
       return this.$createElement('div', props.index)
     }
   }
@@ -317,13 +317,13 @@ const Component = {
 let wrapper = mount(Component, {
   attachTo: '#root'
 })
-expect(wrapper.vm.$el.parentNode).to.not.be.null
+expect(wrapper.vm.$el.parentNode).not.toBeNull()
 wrapper.destroy()
 
 wrapper = mount(Component, {
   attachTo: document.getElementById('root')
 })
-expect(wrapper.vm.$el.parentNode).to.not.be.null
+expect(wrapper.vm.$el.parentNode).not.toBeNull()
 wrapper.destroy()
 ```
 

docs/api/wrapper/findAllComponents.md

@@ -23,5 +23,5 @@ expect(bars).toHaveLength(1)
 ```
 
 ::: warning Usage with CSS selectors
-Using `findAllComponents` with CSS selector is subject to same limitations as [findComponent](api/wrapper/findComponent.md)
+Using `findAllComponents` with CSS selector is subject to same limitations as [findComponent](./findComponent.md)
 :::

docs/api/wrapper/findComponent.md

@@ -26,7 +26,7 @@ expect(barRef.exists()).toBe(true)
 ```
 
 ::: warning Usage with CSS selectors
-Using `findAllComponents` with CSS selector might have confusing behavior
+Using `findComponent` with a CSS selector might have confusing behavior
 
 Consider this example:
 
@@ -50,5 +50,5 @@ const childByCss = wrapper.findComponent('.child')
 expect(childByCss.vm.$options.name).toBe('Root') // => still Root
 ```
 
-The reason for such behavior is that `RootComponent` and `ChildComponent` are sharing same DOM node and only first matching component is included for each unique DOM node
+The reason for such behavior is that `RootComponent` and `ChildComponent` are sharing the same DOM node and only the first matching component is returned for each unique DOM node
 :::

docs/fr/README.md

@@ -7,7 +7,7 @@ Voici la documentation de Vue Test Utils v1, qui vise Vue 2 et les versions ant
 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/).
+- [Vue Test Utils 2](https://github.com/vuejs/test-utils) ciblant [Vue 3](https://github.com/vuejs/core).
 
   <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>
 

docs/fr/api/options.md

@@ -168,7 +168,7 @@ Vous pouvez également passer une fonction qui prend les props comme argument :
 ```js
 shallowMount(Component, {
   scopedSlots: {
-    foo: function(props) {
+    foo: function (props) {
       return this.$createElement('div', props.index)
     }
   }

docs/fr/api/wrapper-array/is.md

@@ -1,5 +1,22 @@
 ## is
 
+::: warning Avertissement de déprédation
+L'utilisation de `is` pour affirmer que le nœud DOM est déprécié et sera supprimé.
+
+Considérez un appariement personnalisé tel que ceux fournis dans [jest-dom](https://github.com/testing-library/jest-dom#custom-matchers).
+ou pour l'assertion de type d'élément DOM, utilisez native [`Element.tagName`](https://developer.mozilla.org/en-US/docs/Web/API/Element/tagName) à la place.
+
+Pour conserver ces tests, un remplacement valable pour :
+
+- `is('DOM_SELECTOR')` est une affirmation de `wrapper.wrappers.every(wrapper => wrapper.element.tagName === 'DOM_SELECTOR')`.
+- `is('ATTR_NAME')` est une affirmation véridique d `wrapper.wrappers.every(wrapper => wrapper.attributes('ATTR_NAME'))`.
+- `is('CLASS_NAME')` est une affirmation véridique d `wrapper.wrappers.every(wrapper => wrapper.classes('CLASS_NAME'))`.
+
+L'affirmation contre la définition du composant n'est pas dépréciée
+
+En cas d'utilisation avec findComponent, accédez à l'élément DOM avec `findComponent(Comp).element`
+:::
+
 Affirmer que chaque `Wrapper` dans le noeud DOM `WrapperArray` ou `vm` correspond à [selector](../selectors.md).
 
 - **Arguments:**

docs/fr/guides/common-tips.md

@@ -221,7 +221,7 @@ En pratique, bien que nous appelions et attendions `setData` pour assurer la mis
 
 ```js
 const transitionStub = () => ({
-  render: function(h) {
+  render: function (h) {
     return this.$options._renderChildren
   }
 })

docs/fr/guides/dom-events.md

@@ -144,7 +144,7 @@ Ce composant permet d'incrémenter/décrémenter la quantité à l'aide de diff
     },
 
     watch: {
-      quantity: function(newValue) {
+      quantity: function (newValue) {
         this.$emit('input', newValue)
       }
     }

docs/fr/installation/using-other-test-runners.md

@@ -12,7 +12,7 @@ Vous trouverez ci-dessous une configuration de base de Karma pour Vue Test Utils
 // karma.conf.js
 var webpackConfig = require('./webpack.config.js')
 
-module.exports = function(config) {
+module.exports = function (config) {
   config.set({
     frameworks: ['mocha'],
     files: ['test/**/*.spec.js'],

docs/guides/common-tips.md

@@ -223,7 +223,7 @@ In practice, although we are calling and awaiting `setData` to ensure the DOM is
 
 ```js
 const transitionStub = () => ({
-  render: function(h) {
+  render: function (h) {
     return this.$options._renderChildren
   }
 })

docs/guides/dom-events.md

@@ -142,7 +142,7 @@ This component allows to increment/decrement the quantity using various keys.
     },
 
     watch: {
-      quantity: function(newValue) {
+      quantity: function (newValue) {
         this.$emit('input', newValue)
       }
     }

docs/installation/using-other-test-runners.md

@@ -12,7 +12,7 @@ Following is a basic Karma config for Vue Test Utils:
 // karma.conf.js
 var webpackConfig = require('./webpack.config.js')
 
-module.exports = function(config) {
+module.exports = function (config) {
   config.set({
     frameworks: ['mocha'],
     files: ['test/**/*.spec.js'],

docs/installation/using-with-jest.md

@@ -17,15 +17,15 @@ The plugin pulls all required dependencies (including jest), creates a `jest.con
 After that, all you need to do is to install Vue Test Utils.
 
 ```bash
-$ npm install --save-dev @vue/test-utils
+$ npm install --save-dev @vue/test-utils@legacy
 ```
 
 ### Manual installation
 
 After setting up Jest, the first thing to do is to install Vue Test Utils and [`vue-jest`](https://github.com/vuejs/vue-jest) to process Single-File Components:
 
 ```bash
-$ npm install --save-dev @vue/test-utils vue-jest
+$ npm install --save-dev @vue/test-utils@legacy vue-jest
 ```
 
 Then, you need to tell Jest to transform `.vue` files using `vue-jest`. You can do so by adding the following configuration in `package.json` or in a standalone [Jest config file](https://jestjs.io/docs/en/configuration):

docs/ja/api/options.md

@@ -94,7 +94,7 @@ props を引数に取る関数を渡すことができます。
 ```js
 shallowMount(Component, {
   scopedSlots: {
-    foo: function(props) {
+    foo: function (props) {
       return this.$createElement('div', props.index)
     }
   }