shallow-mount.spec.js

import { compileToFunctions } from 'vue-template-compiler'
import Vue from 'vue'
import { mount, shallowMount, createLocalVue } from '@vue/test-utils'
import Component from '~resources/components/component.vue'
import ComponentWithChild from '~resources/components/component-with-child.vue'
import ComponentWithNestedChildren from '~resources/components/component-with-nested-children.vue'
import ComponentWithLifecycleHooks from '~resources/components/component-with-lifecycle-hooks.vue'
import ComponentWithoutName from '~resources/components/component-without-name.vue'
import ComponentAsAClassWithChild from '~resources/components/component-as-a-class-with-child.vue'
import ComponentWithVSlotSyntax from '~resources/components/component-with-v-slot-syntax.vue'
import ComponentWithVSlot from '~resources/components/component-with-v-slot.vue'
import RecursiveComponent from '~resources/components/recursive-component.vue'
import { vueVersion } from '~resources/utils'
import { describeRunIf, itDoNotRunIf } from 'conditional-specs'

describeRunIf(process.env.TEST_ENV !== 'node', 'shallowMount', () => {
  const sandbox = sinon.createSandbox()
  beforeEach(() => {
    sandbox.stub(console, 'info').callThrough()
    sandbox.stub(console, 'error').callThrough()
  })

  afterEach(() => {
    sandbox.reset()
    sandbox.restore()
  })

  it('returns new VueWrapper of Vue localVue if no options are passed', () => {
    const compiled = compileToFunctions('<div><input /></div>')
    const wrapper = shallowMount(compiled)
    expect(wrapper.isVueInstance()).to.equal(true)
    expect(wrapper.vm).to.be.an('object')
  })

  it('returns new VueWrapper with all children stubbed', () => {
    const wrapper = shallowMount(ComponentWithNestedChildren)
    expect(wrapper.isVueInstance()).to.equal(true)
    expect(wrapper.findAll(Component).length).to.equal(0)
    expect(wrapper.findAll(ComponentWithChild).length).to.equal(1)
  })

  it('does not modify component directly', () => {
    const wrapper = shallowMount(ComponentWithNestedChildren)
    expect(wrapper.findAll(Component).length).to.equal(0)
    const mountedWrapper = mount(ComponentWithNestedChildren)

    expect(mountedWrapper.findAll(Component).length).to.equal(1)
  })

  it('stubs globally registered components when options.localVue is provided', () => {
    const localVue = Vue.extend()
    localVue.component('registered-component', ComponentWithLifecycleHooks)
    const TestComponent = {
      render: h => h('registered-component')
    }
    shallowMount(TestComponent, { localVue })
    localVue.component('registered-component', ComponentWithLifecycleHooks)
    mount(TestComponent, { localVue })

    expect(console.info.callCount).to.equal(4)
  })

  it('renders children', () => {
    const localVue = createLocalVue()
    localVue.component('child', {
      template: '<div />'
    })
    const TestComponent = {
      template: `<child>{{'Hello'}}</child>`
    }
    const wrapper = shallowMount(TestComponent, {
      localVue
    })
    expect(wrapper.html()).to.equal('<child-stub>Hello</child-stub>')
  })

  it('renders named slots', () => {
    const localVue = createLocalVue()
    localVue.component('child', {
      template: '<div />'
    })
    const TestComponent = {
      template: `
        <child>
          default slot content
          <template slot="header">Hello</template>
          <template slot="footer"><child /></template>
        </child>
      `
    }
    const wrapper = shallowMount(TestComponent, {
      localVue
    })
    expect(wrapper.html()).to.equal(
      '<child-stub>\n' +
        '  default slot content\n' +
        '  <template-stub slot="footer">\n' +
        '    <child-stub></child-stub>\n' +
        '  </template-stub>\n' +
        '  <template-stub slot="header">Hello</template-stub>\n' +
        '</child-stub>'
    )
  })

  it('renders SFC with named slots with v-slot syntax', () => {
    const wrapper = shallowMount(ComponentWithVSlotSyntax)

    expect(wrapper.find(ComponentWithVSlot).exists()).to.equal(true)
    expect(wrapper.find('.new-example').exists()).to.equal(true)
    expect(wrapper.html()).to.equal(
      '<componentwithvslot-stub>\n' +
        '  <template-stub slot="newSyntax">\n' +
        '    <p class="new-example">new slot syntax</p>\n' +
        '  </template-stub>\n' +
        '</componentwithvslot-stub>'
    )
  })

  it('renders named slots with v-slot syntax', () => {
    const localVue = createLocalVue()
    localVue.component('Foo', {
      template: '<div><slot name="newSyntax" /></div>'
    })
    const TestComponent = {
      template: `
        <Foo>
          <template v-slot:newSyntax>
            <p class="new-example">text</p>
          </template>
        </Foo>
      `
    }
    const wrapper = shallowMount(TestComponent, {
      localVue
    })
    expect(wrapper.find({ name: 'Foo' }).exists()).to.equal(true)
    expect(wrapper.find('.new-example').exists()).to.equal(true)
    expect(wrapper.html()).to.equal(
      '<foo-stub>\n' +
        '  <template-stub slot="newSyntax">\n' +
        '    <p class="new-example">text</p>\n' +
        '  </template-stub>\n' +
        '</foo-stub>'
    )
  })

  it('renders no children if none supplied', () => {
    const TestComponent = {
      template: '<child />',
      components: { Child: {} }
    }
    const wrapper = shallowMount(TestComponent)
    expect(wrapper.html()).to.equal('<child-stub></child-stub>')
  })

  it('renders children for functional components', () => {
    const localVue = createLocalVue()
    localVue.component('child', {
      template: '<div />',
      functional: true
    })
    const TestComponent = {
      template: `<child>{{'Hello'}}</child>`
    }
    const wrapper = shallowMount(TestComponent, {
      localVue
    })
    expect(wrapper.html()).to.equal('<child-stub>Hello</child-stub>')
  })

  it('stubs globally registered components', () => {
    Vue.component('registered-component', ComponentWithLifecycleHooks)
    const Component = {
      render: h => h('registered-component')
    }
    shallowMount(Component)
    mount(Component)

    expect(console.info.callCount).to.equal(4)
  })

  itDoNotRunIf(
    vueVersion < 2.1,
    'adds stubbed components to ignored elements',
    () => {
      const TestComponent = {
        template: `
          <div>
            <router-link>
            </router-link>
            <custom-component />
          </div>
        `,
        components: {
          'router-link': {
            template: '<div/>'
          },
          'custom-component': {
            template: '<div/>'
          }
        }
      }
      shallowMount(TestComponent)
      expect(console.error).not.calledWith(sandbox.match('[Vue warn]'))
    }
  )

  itDoNotRunIf(
    vueVersion < 2.2, // $props does not exist in Vue < 2.2
    'renders stubs props',
    () => {
      const TestComponent = {
        template: `<child :prop="propA" attr="hello" />`,
        data: () => ({
          propA: 'a'
        }),
        components: {
          child: {
            props: ['prop']
          }
        }
      }
      const wrapper = shallowMount(TestComponent)
      expect(wrapper.html()).to.contain('<child-stub prop="a" attr="hello"')
    }
  )

  itDoNotRunIf(
    vueVersion < 2.2, // $props does not exist in Vue < 2.2
    'renders stubs classes',
    () => {
      const TestComponent = {
        template: `<child :class="classA" class="b" />`,
        data: () => ({
          classA: 'a'
        }),
        components: {
          child: { template: '<div />' }
        }
      }
      const wrapper = shallowMount(TestComponent)
      expect(wrapper.html()).to.contain('<child-stub class="b a"')
    }
  )

  it('renders stubs props for functional components', () => {
    const TestComponent = {
      template: `<child :prop="propA" attr="hello" />`,
      data: () => ({
        propA: 'a'
      }),
      components: {
        Child: {
          props: ['prop'],
          functional: true
        }
      }
    }
    const wrapper = shallowMount(TestComponent)
    expect(wrapper.html()).to.contain('<child-stub prop="a" attr="hello"')
  })

  it('renders classes for functional components', () => {
    const components = {
      Child: {
        functional: true
      }
    }
    const TestComponent = {
      template: `<child :class="classA" class="b" />`,
      data: () => ({
        classA: 'a'
      }),
      components
    }
    const wrapper = shallowMount(TestComponent)
    expect(wrapper.html()).to.contain('<child-stub class="b a"')
    const TestComponent2 = {
      template: `<child :class="classA"/>`,
      data: () => ({
        classA: 'a'
      }),
      components
    }
    const wrapper2 = shallowMount(TestComponent2)
    expect(wrapper2.html()).to.contain('<child-stub class="a"')
    const TestComponent3 = {
      template: `<child class="b" />`,
      data: () => ({
        classA: 'a'
      }),
      components
    }
    const wrapper3 = shallowMount(TestComponent3)
    expect(wrapper3.html()).to.contain('<child-stub class="b"')
  })

  itDoNotRunIf(vueVersion < 2.1, 'handles recursive components', () => {
    const TestComponent = {
      template: `
          <div>
            <test-component />
          </div>
        `,
      name: 'test-component'
    }
    const wrapper = shallowMount(TestComponent)
    expect(wrapper.html()).to.contain('<test-component-stub>')
    expect(console.error).not.calledWith('[Vue warn]')
  })

  it('does not call stubbed children lifecycle hooks', () => {
    shallowMount(ComponentWithNestedChildren)
    expect(console.info.called).to.equal(false)
  })

  it('stubs extended components', () => {
    const ComponentWithPTag = {
      template: `<p></p>`
    }
    const BaseComponent = {
      template: `
        <div>
          <component-with-p-tag />
        </div>
      `,
      components: {
        ComponentWithPTag
      }
    }

    const TestComponent = {
      extends: BaseComponent
    }

    const wrapper = shallowMount(TestComponent)
    expect(wrapper.find(ComponentWithPTag).exists()).to.equal(true)
    expect(wrapper.find('p').exists()).to.equal(false)
  })

  it('stubs nested extended components', () => {
    const ComponentWithPTag = {
      template: `<p></p>`
    }
    const BaseComponent = {
      template: `
        <div>
          <component-with-p-tag />
        </div>
      `,
      components: {
        ComponentWithPTag
      }
    }

    const ExtendedBaseComponent = {
      extends: BaseComponent
    }

    const TestComponent = {
      extends: ExtendedBaseComponent
    }

    const wrapper = shallowMount(TestComponent)
    expect(wrapper.find(ComponentWithPTag).exists()).to.equal(true)
    expect(wrapper.find('p').exists()).to.equal(false)
  })

  it('stubs components that receive props through mixin', () => {
    const addProps = {
      props: ['a']
    }

    const ChildComponent = {
      template: '<div />',
      mixins: [addProps]
    }

    const ChildComponentExtended = Vue.extend({
      template: '<div />',
      mixins: [addProps]
    })

    const TestComponent = {
      template: `
        <div>
          <child-component a="val" />
          <child-component-extended a="val" />
        </div>
      `,
      components: {
        ChildComponent,
        ChildComponentExtended
      }
    }
    const wrapper = shallowMount(TestComponent)
    expect(wrapper.find(ChildComponent).props('a')).to.equal('val')
    expect(wrapper.find(ChildComponentExtended).props('a')).to.equal('val')
  })

  itDoNotRunIf(vueVersion < 2.3, 'stubs Vue class component children', () => {
    const wrapper = shallowMount(ComponentAsAClassWithChild)
    expect(wrapper.find(Component).exists()).to.equal(true)
    expect(wrapper.findAll('div').length).to.equal(1)
  })

  it('works correctly with find, contains, findAll, and is on unnamed components', () => {
    const TestComponent = {
      template: `
        <div>
            <component-without-name />
        </div>
      `,
      components: {
        ComponentWithoutName
      }
    }
    const wrapper = shallowMount(TestComponent)
    expect(wrapper.contains(ComponentWithoutName)).to.equal(true)
    expect(wrapper.find(ComponentWithoutName).exists()).to.equal(true)
    expect(wrapper.findAll(ComponentWithoutName).length).to.equal(1)
  })

  it('works correctly with find, contains, findAll, and is on named components', () => {
    const TestComponent = {
      template: `
        <div>
            <a-component />
        </div>
      `,
      components: {
        AComponent: Component
      }
    }
    const wrapper = shallowMount(TestComponent)
    expect(wrapper.contains(Component)).to.equal(true)
    expect(wrapper.find(Component).exists()).to.equal(true)
    expect(wrapper.findAll(Component).length).to.equal(1)
  })

  it('works correctly with find on recursive components', () => {
    // this is for a bug that I've been unable to replicate.
    // Sometimes components mutate their components, in this line—
    const wrapper = shallowMount(RecursiveComponent, {
      propsData: {
        items: ['', '']
      }
    })

    expect(wrapper.findAll(RecursiveComponent).length).to.equal(3)
  })

  it('handles extended stubs', () => {
    const ChildComponent = Vue.extend({
      template: '<div />',
      props: ['propA']
    })
    const TestComponent = {
      template: '<child-component propA="hey" />',
      components: { ChildComponent }
    }
    const wrapper = shallowMount(TestComponent, {
      stubs: ['child-component']
    })

    expect(wrapper.find(ChildComponent).vm.propA).to.equal('hey')
  })

  it('does not stub unregistered components', () => {
    const TestComponent = {
      template: '<custom-element />'
    }
    const wrapper = shallowMount(TestComponent)

    expect(wrapper.html()).to.equal('<custom-element></custom-element>')
  })

  it('stubs lazily registered components', () => {
    const Child = {
      render: h => h('p')
    }
    const TestComponent = {
      template: '<div><child /></div>',
      beforeCreate() {
        this.$options.components.Child = Child
      }
    }
    const wrapper = shallowMount(TestComponent)

    expect(wrapper.findAll('p').length).to.equal(0)
    expect(wrapper.findAll(Child).length).to.equal(1)
  })

  itDoNotRunIf(
    vueVersion < 2.4, // auto resolve of default export added in 2.4
    'handles component as dynamic import',
    () => {
      const TestComponent = {
        template: '<div><async-component /></div>',
        components: {
          AsyncComponent: () => import('~resources/components/component.vue')
        }
      }
      shallowMount(TestComponent)
    }
  )

  it('stubs components registered on localVue after multiple installs', () => {
    const myPlugin = function(_Vue, opts) {
      _Vue.mixin({})
    }
    const localVue = createLocalVue()
    localVue.component('registered-component', {
      render: h => h('time')
    })
    const TestComponent = {
      render: h => h('registered-component')
    }

    localVue.use(myPlugin)
    const wrapper = shallowMount(TestComponent, { localVue })
    expect(wrapper.html()).to.contain('registered-component-stub')
  })

  it('throws an error when the component fails to mount', () => {
    expect(() =>
      shallowMount({
        template: '<div></div>',
        mounted: function() {
          throw new Error('Error')
        }
      })
    ).to.throw()
  })

  it('stubs dynamic components', () => {
    const ChildComponent = {
      template: '<div />'
    }
    const TestComponent = {
      template: `
      <div>
        <ChildComponent />
        <component :is="dataComponent" />
        <component :is="computedComponent" />
        <component :is="methodComponent()" />
      </div>
      `,
      components: { ChildComponent },

      data() {
        return {
          dataComponent: ChildComponent
        }
      },

      computed: {
        computedComponent() {
          return ChildComponent
        }
      },

      methods: {
        methodComponent() {
          return ChildComponent
        }
      }
    }
    const wrapper = shallowMount(TestComponent)
    expect(wrapper.html()).to.equal(
      '<div>\n' +
        '  <childcomponent-stub></childcomponent-stub>\n' +
        '  <anonymous-stub></anonymous-stub>\n' +
        '  <anonymous-stub></anonymous-stub>\n' +
        '  <anonymous-stub></anonymous-stub>\n' +
        '</div>'
    )
  })

  itDoNotRunIf(
    vueVersion < 2.1,
    'does not error when rendering a previously stubbed component',
    () => {
      const ChildComponent = {
        render: h => h('div')
      }
      const TestComponent = {
        template: `
        <div>
          <extended-component />
          <keep-alive>
            <child-component />
          </keep-alive>
        </div>
      `,
        components: {
          ExtendedComponent: Vue.extend({ render: h => h('div') }),
          ChildComponent
        }
      }
      shallowMount(TestComponent)
      mount(TestComponent)
      expect(console.error).not.calledWith(
        sandbox.match('Unknown custom element')
      )
    }
  )

  itDoNotRunIf(vueVersion < 2.2, 'stubs model', () => {
    const ChildComponent = {
      template: '<div />',
      model: {
        prop: 'a',
        event: 'change'
      },
      props: ['a']
    }
    const TestComponent = {
      template: '<child-component v-model="val" />',
      data() {
        return {
          val: '123'
        }
      },
      components: { ChildComponent }
    }
    const wrapper = shallowMount(TestComponent)
    expect(wrapper.find(ChildComponent).vm.a).to.equal('123')
  })
})