2020-04-07 05:37:47 +08:00
|
|
|
import {
|
|
|
|
ComponentInternalInstance,
|
|
|
|
getCurrentInstance,
|
|
|
|
render,
|
|
|
|
h,
|
|
|
|
nodeOps,
|
|
|
|
FunctionalComponent,
|
|
|
|
defineComponent,
|
2020-06-10 04:20:33 +08:00
|
|
|
ref,
|
2020-09-01 06:32:07 +08:00
|
|
|
serializeInner,
|
2020-09-18 03:59:01 +08:00
|
|
|
createApp,
|
|
|
|
provide,
|
|
|
|
inject
|
2020-04-07 05:37:47 +08:00
|
|
|
} from '@vue/runtime-test'
|
|
|
|
import { render as domRender, nextTick } from 'vue'
|
|
|
|
|
|
|
|
describe('component props', () => {
|
|
|
|
test('stateful', () => {
|
|
|
|
let props: any
|
|
|
|
let attrs: any
|
|
|
|
let proxy: any
|
|
|
|
|
|
|
|
const Comp = defineComponent({
|
2020-06-26 21:16:06 +08:00
|
|
|
props: ['fooBar', 'barBaz'],
|
2020-04-07 05:37:47 +08:00
|
|
|
render() {
|
|
|
|
props = this.$props
|
|
|
|
attrs = this.$attrs
|
|
|
|
proxy = this
|
|
|
|
}
|
|
|
|
})
|
|
|
|
|
|
|
|
const root = nodeOps.createElement('div')
|
2020-04-14 00:37:31 +08:00
|
|
|
render(h(Comp, { fooBar: 1, bar: 2 }), root)
|
|
|
|
expect(proxy.fooBar).toBe(1)
|
|
|
|
expect(props).toEqual({ fooBar: 1 })
|
2020-04-07 05:37:47 +08:00
|
|
|
expect(attrs).toEqual({ bar: 2 })
|
|
|
|
|
2020-04-14 00:37:31 +08:00
|
|
|
// test passing kebab-case and resolving to camelCase
|
|
|
|
render(h(Comp, { 'foo-bar': 2, bar: 3, baz: 4 }), root)
|
|
|
|
expect(proxy.fooBar).toBe(2)
|
|
|
|
expect(props).toEqual({ fooBar: 2 })
|
|
|
|
expect(attrs).toEqual({ bar: 3, baz: 4 })
|
|
|
|
|
|
|
|
// test updating kebab-case should not delete it (#955)
|
2020-06-26 21:16:06 +08:00
|
|
|
render(h(Comp, { 'foo-bar': 3, bar: 3, baz: 4, barBaz: 5 }), root)
|
2020-04-14 00:37:31 +08:00
|
|
|
expect(proxy.fooBar).toBe(3)
|
2020-06-26 21:16:06 +08:00
|
|
|
expect(proxy.barBaz).toBe(5)
|
2020-07-17 06:18:52 +08:00
|
|
|
expect(props).toEqual({ fooBar: 3, barBaz: 5 })
|
2020-04-07 05:37:47 +08:00
|
|
|
expect(attrs).toEqual({ bar: 3, baz: 4 })
|
|
|
|
|
|
|
|
render(h(Comp, { qux: 5 }), root)
|
2020-04-14 00:37:31 +08:00
|
|
|
expect(proxy.fooBar).toBeUndefined()
|
2020-06-26 21:16:06 +08:00
|
|
|
// remove the props with camelCase key (#1412)
|
|
|
|
expect(proxy.barBaz).toBeUndefined()
|
2020-04-07 05:37:47 +08:00
|
|
|
expect(props).toEqual({})
|
|
|
|
expect(attrs).toEqual({ qux: 5 })
|
|
|
|
})
|
|
|
|
|
|
|
|
test('stateful with setup', () => {
|
|
|
|
let props: any
|
|
|
|
let attrs: any
|
|
|
|
|
|
|
|
const Comp = defineComponent({
|
|
|
|
props: ['foo'],
|
|
|
|
setup(_props, { attrs: _attrs }) {
|
|
|
|
return () => {
|
|
|
|
props = _props
|
|
|
|
attrs = _attrs
|
|
|
|
}
|
|
|
|
}
|
|
|
|
})
|
|
|
|
|
|
|
|
const root = nodeOps.createElement('div')
|
|
|
|
render(h(Comp, { foo: 1, bar: 2 }), root)
|
|
|
|
expect(props).toEqual({ foo: 1 })
|
|
|
|
expect(attrs).toEqual({ bar: 2 })
|
|
|
|
|
|
|
|
render(h(Comp, { foo: 2, bar: 3, baz: 4 }), root)
|
|
|
|
expect(props).toEqual({ foo: 2 })
|
|
|
|
expect(attrs).toEqual({ bar: 3, baz: 4 })
|
|
|
|
|
|
|
|
render(h(Comp, { qux: 5 }), root)
|
|
|
|
expect(props).toEqual({})
|
|
|
|
expect(attrs).toEqual({ qux: 5 })
|
|
|
|
})
|
|
|
|
|
|
|
|
test('functional with declaration', () => {
|
|
|
|
let props: any
|
|
|
|
let attrs: any
|
|
|
|
|
|
|
|
const Comp: FunctionalComponent = (_props, { attrs: _attrs }) => {
|
|
|
|
props = _props
|
|
|
|
attrs = _attrs
|
|
|
|
}
|
|
|
|
Comp.props = ['foo']
|
|
|
|
|
|
|
|
const root = nodeOps.createElement('div')
|
|
|
|
render(h(Comp, { foo: 1, bar: 2 }), root)
|
|
|
|
expect(props).toEqual({ foo: 1 })
|
|
|
|
expect(attrs).toEqual({ bar: 2 })
|
|
|
|
|
|
|
|
render(h(Comp, { foo: 2, bar: 3, baz: 4 }), root)
|
|
|
|
expect(props).toEqual({ foo: 2 })
|
|
|
|
expect(attrs).toEqual({ bar: 3, baz: 4 })
|
|
|
|
|
|
|
|
render(h(Comp, { qux: 5 }), root)
|
|
|
|
expect(props).toEqual({})
|
|
|
|
expect(attrs).toEqual({ qux: 5 })
|
|
|
|
})
|
|
|
|
|
|
|
|
test('functional without declaration', () => {
|
|
|
|
let props: any
|
|
|
|
let attrs: any
|
|
|
|
const Comp: FunctionalComponent = (_props, { attrs: _attrs }) => {
|
|
|
|
props = _props
|
|
|
|
attrs = _attrs
|
|
|
|
}
|
|
|
|
const root = nodeOps.createElement('div')
|
|
|
|
|
|
|
|
render(h(Comp, { foo: 1 }), root)
|
|
|
|
expect(props).toEqual({ foo: 1 })
|
|
|
|
expect(attrs).toEqual({ foo: 1 })
|
|
|
|
expect(props).toBe(attrs)
|
|
|
|
|
|
|
|
render(h(Comp, { bar: 2 }), root)
|
|
|
|
expect(props).toEqual({ bar: 2 })
|
|
|
|
expect(attrs).toEqual({ bar: 2 })
|
|
|
|
expect(props).toBe(attrs)
|
|
|
|
})
|
|
|
|
|
|
|
|
test('boolean casting', () => {
|
|
|
|
let proxy: any
|
|
|
|
const Comp = {
|
|
|
|
props: {
|
|
|
|
foo: Boolean,
|
|
|
|
bar: Boolean,
|
|
|
|
baz: Boolean,
|
|
|
|
qux: Boolean
|
|
|
|
},
|
|
|
|
render() {
|
|
|
|
proxy = this
|
|
|
|
}
|
|
|
|
}
|
|
|
|
render(
|
|
|
|
h(Comp, {
|
|
|
|
// absent should cast to false
|
|
|
|
bar: '', // empty string should cast to true
|
|
|
|
baz: 'baz', // same string should cast to true
|
|
|
|
qux: 'ok' // other values should be left in-tact (but raise warning)
|
|
|
|
}),
|
|
|
|
nodeOps.createElement('div')
|
|
|
|
)
|
|
|
|
|
|
|
|
expect(proxy.foo).toBe(false)
|
|
|
|
expect(proxy.bar).toBe(true)
|
|
|
|
expect(proxy.baz).toBe(true)
|
|
|
|
expect(proxy.qux).toBe('ok')
|
|
|
|
expect('type check failed for prop "qux"').toHaveBeenWarned()
|
|
|
|
})
|
|
|
|
|
|
|
|
test('default value', () => {
|
|
|
|
let proxy: any
|
2020-04-21 02:16:25 +08:00
|
|
|
const defaultFn = jest.fn(() => ({ a: 1 }))
|
2020-06-12 21:06:28 +08:00
|
|
|
const defaultBaz = jest.fn(() => ({ b: 1 }))
|
2020-04-21 02:16:25 +08:00
|
|
|
|
2020-04-07 05:37:47 +08:00
|
|
|
const Comp = {
|
|
|
|
props: {
|
|
|
|
foo: {
|
|
|
|
default: 1
|
|
|
|
},
|
|
|
|
bar: {
|
2020-04-21 02:16:25 +08:00
|
|
|
default: defaultFn
|
2020-06-12 21:06:28 +08:00
|
|
|
},
|
|
|
|
baz: {
|
|
|
|
type: Function,
|
|
|
|
default: defaultBaz
|
2020-04-07 05:37:47 +08:00
|
|
|
}
|
|
|
|
},
|
|
|
|
render() {
|
|
|
|
proxy = this
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
const root = nodeOps.createElement('div')
|
|
|
|
render(h(Comp, { foo: 2 }), root)
|
|
|
|
expect(proxy.foo).toBe(2)
|
2020-04-21 02:16:25 +08:00
|
|
|
const prevBar = proxy.bar
|
|
|
|
expect(proxy.bar).toEqual({ a: 1 })
|
2020-06-12 21:06:28 +08:00
|
|
|
expect(proxy.baz).toEqual(defaultBaz)
|
2020-04-21 02:16:25 +08:00
|
|
|
expect(defaultFn).toHaveBeenCalledTimes(1)
|
2020-06-12 21:06:28 +08:00
|
|
|
expect(defaultBaz).toHaveBeenCalledTimes(0)
|
2020-04-21 02:16:25 +08:00
|
|
|
|
|
|
|
// #999: updates should not cause default factory of unchanged prop to be
|
|
|
|
// called again
|
|
|
|
render(h(Comp, { foo: 3 }), root)
|
|
|
|
expect(proxy.foo).toBe(3)
|
2020-04-07 05:37:47 +08:00
|
|
|
expect(proxy.bar).toEqual({ a: 1 })
|
2020-04-21 02:16:25 +08:00
|
|
|
expect(proxy.bar).toBe(prevBar)
|
|
|
|
expect(defaultFn).toHaveBeenCalledTimes(1)
|
2020-04-07 05:37:47 +08:00
|
|
|
|
2020-04-15 04:17:35 +08:00
|
|
|
render(h(Comp, { bar: { b: 2 } }), root)
|
2020-04-07 05:37:47 +08:00
|
|
|
expect(proxy.foo).toBe(1)
|
|
|
|
expect(proxy.bar).toEqual({ b: 2 })
|
2020-04-21 02:16:25 +08:00
|
|
|
expect(defaultFn).toHaveBeenCalledTimes(1)
|
2020-04-15 04:17:35 +08:00
|
|
|
|
|
|
|
render(h(Comp, { foo: 3, bar: { b: 3 } }), root)
|
|
|
|
expect(proxy.foo).toBe(3)
|
|
|
|
expect(proxy.bar).toEqual({ b: 3 })
|
2020-04-21 02:16:25 +08:00
|
|
|
expect(defaultFn).toHaveBeenCalledTimes(1)
|
2020-04-15 04:17:35 +08:00
|
|
|
|
|
|
|
render(h(Comp, { bar: { b: 4 } }), root)
|
|
|
|
expect(proxy.foo).toBe(1)
|
|
|
|
expect(proxy.bar).toEqual({ b: 4 })
|
2020-04-21 02:16:25 +08:00
|
|
|
expect(defaultFn).toHaveBeenCalledTimes(1)
|
2020-04-07 05:37:47 +08:00
|
|
|
})
|
|
|
|
|
2020-09-18 03:59:01 +08:00
|
|
|
test('using inject in default value factory', () => {
|
|
|
|
const Child = defineComponent({
|
|
|
|
props: {
|
|
|
|
test: {
|
|
|
|
default: () => inject('test', 'default')
|
|
|
|
}
|
|
|
|
},
|
|
|
|
setup(props) {
|
|
|
|
return () => {
|
|
|
|
return h('div', props.test)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
})
|
|
|
|
|
|
|
|
const Comp = {
|
|
|
|
setup() {
|
|
|
|
provide('test', 'injected')
|
|
|
|
return () => h(Child)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
const root = nodeOps.createElement('div')
|
|
|
|
render(h(Comp), root)
|
|
|
|
expect(serializeInner(root)).toBe(`<div>injected</div>`)
|
|
|
|
})
|
|
|
|
|
2020-04-07 05:37:47 +08:00
|
|
|
test('optimized props updates', async () => {
|
|
|
|
const Child = defineComponent({
|
|
|
|
props: ['foo'],
|
|
|
|
template: `<div>{{ foo }}</div>`
|
|
|
|
})
|
|
|
|
|
|
|
|
const foo = ref(1)
|
|
|
|
const id = ref('a')
|
|
|
|
|
|
|
|
const Comp = defineComponent({
|
|
|
|
setup() {
|
|
|
|
return {
|
|
|
|
foo,
|
|
|
|
id
|
|
|
|
}
|
|
|
|
},
|
|
|
|
components: { Child },
|
|
|
|
template: `<Child :foo="foo" :id="id"/>`
|
|
|
|
})
|
|
|
|
|
|
|
|
// Note this one is using the main Vue render so it can compile template
|
|
|
|
// on the fly
|
|
|
|
const root = document.createElement('div')
|
|
|
|
domRender(h(Comp), root)
|
|
|
|
expect(root.innerHTML).toBe('<div id="a">1</div>')
|
|
|
|
|
|
|
|
foo.value++
|
|
|
|
await nextTick()
|
|
|
|
expect(root.innerHTML).toBe('<div id="a">2</div>')
|
|
|
|
|
|
|
|
id.value = 'b'
|
|
|
|
await nextTick()
|
|
|
|
expect(root.innerHTML).toBe('<div id="b">2</div>')
|
|
|
|
})
|
|
|
|
|
|
|
|
test('warn props mutation', () => {
|
|
|
|
let instance: ComponentInternalInstance
|
|
|
|
let setupProps: any
|
|
|
|
const Comp = {
|
|
|
|
props: ['foo'],
|
|
|
|
setup(props: any) {
|
|
|
|
instance = getCurrentInstance()!
|
|
|
|
setupProps = props
|
|
|
|
return () => null
|
|
|
|
}
|
|
|
|
}
|
|
|
|
render(h(Comp, { foo: 1 }), nodeOps.createElement('div'))
|
|
|
|
expect(setupProps.foo).toBe(1)
|
|
|
|
expect(instance!.props.foo).toBe(1)
|
|
|
|
setupProps.foo = 2
|
|
|
|
expect(`Set operation on key "foo" failed`).toHaveBeenWarned()
|
|
|
|
expect(() => {
|
|
|
|
;(instance!.proxy as any).foo = 2
|
|
|
|
}).toThrow(TypeError)
|
|
|
|
expect(`Attempting to mutate prop "foo"`).toHaveBeenWarned()
|
2021-02-06 02:59:46 +08:00
|
|
|
// should not throw when overriding properties other than props
|
|
|
|
expect(() => {
|
|
|
|
;(instance!.proxy as any).hasOwnProperty = () => {}
|
|
|
|
}).not.toThrow(TypeError)
|
2020-04-07 05:37:47 +08:00
|
|
|
})
|
2020-06-10 04:20:33 +08:00
|
|
|
|
2021-03-26 04:22:43 +08:00
|
|
|
test('warn absent required props', () => {
|
|
|
|
const Comp = {
|
|
|
|
props: {
|
|
|
|
bool: { type: Boolean, required: true },
|
|
|
|
str: { type: String, required: true },
|
|
|
|
num: { type: Number, required: true }
|
|
|
|
},
|
|
|
|
setup() {
|
|
|
|
return () => null
|
|
|
|
}
|
|
|
|
}
|
|
|
|
render(h(Comp), nodeOps.createElement('div'))
|
|
|
|
expect(`Missing required prop: "bool"`).toHaveBeenWarned()
|
|
|
|
expect(`Missing required prop: "str"`).toHaveBeenWarned()
|
|
|
|
expect(`Missing required prop: "num"`).toHaveBeenWarned()
|
|
|
|
})
|
|
|
|
|
2020-06-10 04:20:33 +08:00
|
|
|
test('merging props from mixins and extends', () => {
|
|
|
|
let setupProps: any
|
|
|
|
let renderProxy: any
|
|
|
|
|
|
|
|
const E = {
|
|
|
|
props: ['base']
|
|
|
|
}
|
|
|
|
const M1 = {
|
|
|
|
props: ['m1']
|
|
|
|
}
|
|
|
|
const M2 = {
|
|
|
|
props: { m2: null }
|
|
|
|
}
|
|
|
|
const Comp = {
|
|
|
|
props: ['self'],
|
|
|
|
mixins: [M1, M2],
|
|
|
|
extends: E,
|
|
|
|
setup(props: any) {
|
|
|
|
setupProps = props
|
|
|
|
},
|
|
|
|
render(this: any) {
|
|
|
|
renderProxy = this
|
|
|
|
return h('div', [this.self, this.base, this.m1, this.m2])
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
const root = nodeOps.createElement('div')
|
|
|
|
const props = {
|
|
|
|
self: 'from self, ',
|
|
|
|
base: 'from base, ',
|
|
|
|
m1: 'from mixin 1, ',
|
|
|
|
m2: 'from mixin 2'
|
|
|
|
}
|
|
|
|
render(h(Comp, props), root)
|
|
|
|
|
|
|
|
expect(serializeInner(root)).toMatch(
|
|
|
|
`from self, from base, from mixin 1, from mixin 2`
|
|
|
|
)
|
|
|
|
expect(setupProps).toMatchObject(props)
|
|
|
|
expect(renderProxy.$props).toMatchObject(props)
|
|
|
|
})
|
2020-09-01 06:32:07 +08:00
|
|
|
|
|
|
|
test('merging props from global mixins', () => {
|
|
|
|
let setupProps: any
|
|
|
|
let renderProxy: any
|
|
|
|
|
|
|
|
const M1 = {
|
|
|
|
props: ['m1']
|
|
|
|
}
|
|
|
|
const M2 = {
|
|
|
|
props: { m2: null }
|
|
|
|
}
|
|
|
|
const Comp = {
|
|
|
|
props: ['self'],
|
|
|
|
setup(props: any) {
|
|
|
|
setupProps = props
|
|
|
|
},
|
|
|
|
render(this: any) {
|
|
|
|
renderProxy = this
|
|
|
|
return h('div', [this.self, this.m1, this.m2])
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
const props = {
|
|
|
|
self: 'from self, ',
|
|
|
|
m1: 'from mixin 1, ',
|
|
|
|
m2: 'from mixin 2'
|
|
|
|
}
|
|
|
|
const app = createApp(Comp, props)
|
|
|
|
app.mixin(M1)
|
|
|
|
app.mixin(M2)
|
|
|
|
|
|
|
|
const root = nodeOps.createElement('div')
|
|
|
|
app.mount(root)
|
|
|
|
|
|
|
|
expect(serializeInner(root)).toMatch(
|
|
|
|
`from self, from mixin 1, from mixin 2`
|
|
|
|
)
|
|
|
|
expect(setupProps).toMatchObject(props)
|
|
|
|
expect(renderProxy.$props).toMatchObject(props)
|
|
|
|
})
|
2021-02-04 02:25:45 +08:00
|
|
|
|
|
|
|
test('props type support BigInt', () => {
|
|
|
|
const Comp = {
|
|
|
|
props: {
|
|
|
|
foo: BigInt
|
|
|
|
},
|
|
|
|
render(this: any) {
|
|
|
|
return h('div', [this.foo])
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
const root = nodeOps.createElement('div')
|
|
|
|
render(
|
|
|
|
h(Comp, {
|
|
|
|
foo: BigInt(BigInt(100000111)) + BigInt(2000000000) * BigInt(30000000)
|
|
|
|
}),
|
|
|
|
root
|
|
|
|
)
|
|
|
|
|
|
|
|
expect(serializeInner(root)).toMatch('<div>60000000100000111</div>')
|
|
|
|
})
|
2020-04-07 05:37:47 +08:00
|
|
|
})
|