.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/**

.github/CONTRIBUTING.md

@@ -57,9 +57,6 @@ $ yarn test:unit
 
 # run the full test suite, include linting / type checking
 $ yarn test
-
-# run tests against src files only. Allows inline debugging.
-$ yarn test:unit:only:dev
 ```
 
 There are some other scripts available in the `scripts` section of the `package.json` file.

.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

@@ -19,6 +19,16 @@ module.exports = {
       lang: 'ru',
       title: 'Vue Test Utils',
       description: 'Библиотека для тестирования Vue-компонентов'
+    },
+    '/fr/': {
+      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'],
@@ -54,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/'
               }
             ]
           },
@@ -89,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/'
               }
             ]
           }
@@ -120,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/'
               }
             ]
           }
@@ -151,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/'
               }
             ]
           }
@@ -167,6 +177,72 @@ 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: 'v2 (Vue.js 3)',
+                link: 'https://test-utils.vuejs.org/'
+              }
+            ]
+          }
+        ],
+        sidebar: [
+          '/fr/',
+          '/fr/installation/',
+          '/fr/guides/',
+          '/fr/api/',
+          '/fr/api/wrapper/',
+          '/fr/api/wrapper-array/',
+          '/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/components/RouterLinkStub.md

@@ -16,5 +16,5 @@ const wrapper = mount(Component, {
     RouterLink: RouterLinkStub
   }
 })
-expect(wrapper.find(RouterLinkStub).props().to).toBe('/some/path')
+expect(wrapper.findComponent(RouterLinkStub).props().to).toBe('/some/path')
 ```

docs/api/config.md

@@ -38,7 +38,7 @@ config.showDeprecationWarnings = true
 config.deprecationWarningHandler = (method, message) => {
   if (method === 'emittedByOrder') return
 
-  console.error(msg)
+  console.error(message)
 }
 ```
 

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()
 ```
 
@@ -336,15 +336,12 @@ wrapper.destroy()
 `attachToDocument` is deprecated and will be removed in future releases. Use [`attachTo`](#attachto) instead. For example, if you need to attach the component to the document.body:
 
 ```js
-const elem = document.createElement('div')
-if (document.body) {
-  document.body.appendChild(elem)
-}
 wrapper = mount(Component, {
-  attachTo: elem
+  attachTo: document.body
 })
 ```
 
+For more information, see [`attachTo`](#attachto)'s tip above.
 :::
 
 Like [`attachTo`](#attachto), but automatically creates a new `div` element for you and inserts it into the body.

docs/api/wrapper-array/contains.md

@@ -1,4 +1,4 @@
-### contains
+## contains
 
 Assert every wrapper in `WrapperArray` contains selector.
 

docs/api/wrapper/findAllComponents.md

@@ -4,7 +4,7 @@ Returns a [`WrapperArray`](../wrapper-array/) of all matching Vue components.
 
 - **Arguments:**
 
-  - `{Component|ref|name} selector`
+  - `selector` Use any valid [selector](../selectors.md)
 
 - **Returns:** `{WrapperArray}`
 
@@ -19,5 +19,9 @@ const wrapper = mount(Foo)
 const bar = wrapper.findAllComponents(Bar).at(0)
 expect(bar.exists()).toBeTruthy()
 const bars = wrapper.findAllComponents(Bar)
-expect(bar).toHaveLength(1)
+expect(bars).toHaveLength(1)
 ```
+
+::: warning Usage with CSS selectors
+Using `findAllComponents` with CSS selector is subject to same limitations as [findComponent](./findComponent.md)
+:::

docs/api/wrapper/findComponent.md

@@ -4,7 +4,7 @@ Returns `Wrapper` of first matching Vue component.
 
 - **Arguments:**
 
-  - `{Component|ref|name} selector`
+  - `{Component|ref|string} selector`
 
 - **Returns:** `{Wrapper}`
 
@@ -24,3 +24,31 @@ expect(barByName.exists()).toBe(true)
 const barRef = wrapper.findComponent({ ref: 'bar' }) // => finds Bar by `ref`
 expect(barRef.exists()).toBe(true)
 ```
+
+::: warning Usage with CSS selectors
+Using `findComponent` with a CSS selector might have confusing behavior
+
+Consider this example:
+
+```js
+const ChildComponent = {
+  name: 'Child',
+  template: '<div class="child"></div>'
+}
+
+const RootComponent = {
+  name: 'Root',
+  components: { ChildComponent },
+  template: '<child-component class="root" />'
+}
+
+const wrapper = mount(RootComponent)
+
+const rootByCss = wrapper.findComponent('.root') // => finds Root
+expect(rootByCss.vm.$options.name).toBe('Root')
+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 the same DOM node and only the first matching component is returned for each unique DOM node
+:::

docs/api/wrapper/setProps.md

@@ -9,7 +9,7 @@
 Sets `Wrapper` `vm` props and forces update.
 
 ::: warning
-`setProps` could be called only for top-level component, mounted by `mount` or `shallowMount`
+`setProps` should be called only for top-level component, mounted by `mount` or `shallowMount`
 :::
 
 ```js

docs/api/wrapper/trigger.md

@@ -38,6 +38,10 @@ test('trigger demo', async () => {
 })
 ```
 
+::: tip
+When using `trigger('focus')` with [jsdom v16.4.0](https://github.com/jsdom/jsdom/releases/tag/16.4.0) and above you must use the [attachTo](../options.md#attachto) option when mounting the component. This is because a bug fix in [jsdom v16.4.0](https://github.com/jsdom/jsdom/releases/tag/16.4.0) changed `el.focus()` to do nothing on elements that are disconnected from the DOM.
+:::
+
 - **Setting the event target:**
 
 Under the hood, `trigger` creates an `Event` object and dispatches the event on the Wrapper element.