09b4202a22
BREAKING CHANGE: Reactivity APIs adjustments: - `readonly` is now non-tracking if called on plain objects. `lock` and `unlock` have been removed. A `readonly` proxy can no longer be directly mutated. However, it can still wrap an already reactive object and track changes to the source reactive object. - `isReactive` now only returns true for proxies created by `reactive`, or a `readonly` proxy that wraps a `reactive` proxy. - A new utility `isProxy` is introduced, which returns true for both reactive or readonly proxies. - `markNonReactive` has been renamed to `markRaw`.
178 lines
4.6 KiB
TypeScript
178 lines
4.6 KiB
TypeScript
import { ref, isRef } from '../src/ref'
|
|
import {
|
|
reactive,
|
|
isReactive,
|
|
toRaw,
|
|
markRaw,
|
|
shallowReactive
|
|
} from '../src/reactive'
|
|
import { mockWarn } from '@vue/shared'
|
|
import { computed } from '../src/computed'
|
|
|
|
describe('reactivity/reactive', () => {
|
|
mockWarn()
|
|
|
|
test('Object', () => {
|
|
const original = { foo: 1 }
|
|
const observed = reactive(original)
|
|
expect(observed).not.toBe(original)
|
|
expect(isReactive(observed)).toBe(true)
|
|
expect(isReactive(original)).toBe(false)
|
|
// get
|
|
expect(observed.foo).toBe(1)
|
|
// has
|
|
expect('foo' in observed).toBe(true)
|
|
// ownKeys
|
|
expect(Object.keys(observed)).toEqual(['foo'])
|
|
})
|
|
|
|
test('nested reactives', () => {
|
|
const original = {
|
|
nested: {
|
|
foo: 1
|
|
},
|
|
array: [{ bar: 2 }]
|
|
}
|
|
const observed = reactive(original)
|
|
expect(isReactive(observed.nested)).toBe(true)
|
|
expect(isReactive(observed.array)).toBe(true)
|
|
expect(isReactive(observed.array[0])).toBe(true)
|
|
})
|
|
|
|
test('observed value should proxy mutations to original (Object)', () => {
|
|
const original: any = { foo: 1 }
|
|
const observed = reactive(original)
|
|
// set
|
|
observed.bar = 1
|
|
expect(observed.bar).toBe(1)
|
|
expect(original.bar).toBe(1)
|
|
// delete
|
|
delete observed.foo
|
|
expect('foo' in observed).toBe(false)
|
|
expect('foo' in original).toBe(false)
|
|
})
|
|
|
|
test('setting a property with an unobserved value should wrap with reactive', () => {
|
|
const observed = reactive<{ foo?: object }>({})
|
|
const raw = {}
|
|
observed.foo = raw
|
|
expect(observed.foo).not.toBe(raw)
|
|
expect(isReactive(observed.foo)).toBe(true)
|
|
})
|
|
|
|
test('observing already observed value should return same Proxy', () => {
|
|
const original = { foo: 1 }
|
|
const observed = reactive(original)
|
|
const observed2 = reactive(observed)
|
|
expect(observed2).toBe(observed)
|
|
})
|
|
|
|
test('observing the same value multiple times should return same Proxy', () => {
|
|
const original = { foo: 1 }
|
|
const observed = reactive(original)
|
|
const observed2 = reactive(original)
|
|
expect(observed2).toBe(observed)
|
|
})
|
|
|
|
test('should not pollute original object with Proxies', () => {
|
|
const original: any = { foo: 1 }
|
|
const original2 = { bar: 2 }
|
|
const observed = reactive(original)
|
|
const observed2 = reactive(original2)
|
|
observed.bar = observed2
|
|
expect(observed.bar).toBe(observed2)
|
|
expect(original.bar).toBe(original2)
|
|
})
|
|
|
|
test('unwrap', () => {
|
|
const original = { foo: 1 }
|
|
const observed = reactive(original)
|
|
expect(toRaw(observed)).toBe(original)
|
|
expect(toRaw(original)).toBe(original)
|
|
})
|
|
|
|
test('should not unwrap Ref<T>', () => {
|
|
const observedNumberRef = reactive(ref(1))
|
|
const observedObjectRef = reactive(ref({ foo: 1 }))
|
|
|
|
expect(isRef(observedNumberRef)).toBe(true)
|
|
expect(isRef(observedObjectRef)).toBe(true)
|
|
})
|
|
|
|
test('should unwrap computed refs', () => {
|
|
// readonly
|
|
const a = computed(() => 1)
|
|
// writable
|
|
const b = computed({
|
|
get: () => 1,
|
|
set: () => {}
|
|
})
|
|
const obj = reactive({ a, b })
|
|
// check type
|
|
obj.a + 1
|
|
obj.b + 1
|
|
expect(typeof obj.a).toBe(`number`)
|
|
expect(typeof obj.b).toBe(`number`)
|
|
})
|
|
|
|
test('non-observable values', () => {
|
|
const assertValue = (value: any) => {
|
|
reactive(value)
|
|
expect(
|
|
`value cannot be made reactive: ${String(value)}`
|
|
).toHaveBeenWarnedLast()
|
|
}
|
|
|
|
// number
|
|
assertValue(1)
|
|
// string
|
|
assertValue('foo')
|
|
// boolean
|
|
assertValue(false)
|
|
// null
|
|
assertValue(null)
|
|
// undefined
|
|
assertValue(undefined)
|
|
// symbol
|
|
const s = Symbol()
|
|
assertValue(s)
|
|
|
|
// built-ins should work and return same value
|
|
const p = Promise.resolve()
|
|
expect(reactive(p)).toBe(p)
|
|
const r = new RegExp('')
|
|
expect(reactive(r)).toBe(r)
|
|
const d = new Date()
|
|
expect(reactive(d)).toBe(d)
|
|
})
|
|
|
|
test('markRaw', () => {
|
|
const obj = reactive({
|
|
foo: { a: 1 },
|
|
bar: markRaw({ b: 2 })
|
|
})
|
|
expect(isReactive(obj.foo)).toBe(true)
|
|
expect(isReactive(obj.bar)).toBe(false)
|
|
})
|
|
|
|
test('should not observe frozen objects', () => {
|
|
const obj = reactive({
|
|
foo: Object.freeze({ a: 1 })
|
|
})
|
|
expect(isReactive(obj.foo)).toBe(false)
|
|
})
|
|
|
|
describe('shallowReactive', () => {
|
|
test('should not make non-reactive properties reactive', () => {
|
|
const props = shallowReactive({ n: { foo: 1 } })
|
|
expect(isReactive(props.n)).toBe(false)
|
|
})
|
|
|
|
test('should keep reactive properties reactive', () => {
|
|
const props: any = shallowReactive({ n: reactive({ foo: 1 }) })
|
|
props.n = reactive({ foo: 2 })
|
|
expect(isReactive(props.n)).toBe(true)
|
|
})
|
|
})
|
|
})
|