reactive

定义: 接收一个普通对象然后返回该普通对象的响应式代理。等同于 2.x 的 Vue.observable()

  1. const obj = reactive({ count: 0 })

响应式转换是“深层的”:会影响对象内部所有嵌套的属性。基于 ES2015Proxy 实现,返回的代理对象不等于原始对象。建议仅使用代理对象而避免依赖原始对象。

更多API https://vue3js.cn/vue-composition-api/#reactive

正文

Vue3中响应数据核心是 reactivereactive 中的实现是由 proxyeffect 组合,先来看一下 reactive 方法的定义

  1. export function reactive<T extends object>(target: T): UnwrapNestedRefs<T>
  2. export function reactive(target: object) {
  3. // if trying to observe a readonly proxy, return the readonly version.
  4. // 如果目标对象是一个只读的响应数据,则直接返回目标对象
  5. if (target && (target as Target).__v_isReadonly) {
  6. return target
  7. }
  8. // 否则调用 createReactiveObject 创建 observe
  9. return createReactiveObject(
  10. target,
  11. false,
  12. mutableHandlers,
  13. mutableCollectionHandlers
  14. )
  15. }

createReactiveObject 创建 observe

  1. // Target 目标对象
  2. // isReadonly 是否只读
  3. // baseHandlers 基本类型的 handlers
  4. // collectionHandlers 主要针对(set、map、weakSet、weakMap)的 handlers
  5. function createReactiveObject(
  6. target: Target,
  7. isReadonly: boolean,
  8. baseHandlers: ProxyHandler<any>,
  9. collectionHandlers: ProxyHandler<any>
  10. ) {
  11. // 如果不是对象
  12. if (!isObject(target)) {
  13. // 在开发模式抛出警告,生产环境直接返回目标对象
  14. if (__DEV__) {
  15. console.warn(`value cannot be made reactive: ${String(target)}`)
  16. }
  17. return target
  18. }
  19. // target is already a Proxy, return it.
  20. // exception: calling readonly() on a reactive object
  21. // 如果目标对象已经是个 proxy 直接返回
  22. if (target.__v_raw && !(isReadonly && target.__v_isReactive)) {
  23. return target
  24. }
  25. // target already has corresponding Proxy
  26. if (
  27. hasOwn(target, isReadonly ? ReactiveFlags.readonly : ReactiveFlags.reactive)
  28. ) {
  29. return isReadonly ? target.__v_readonly : target.__v_reactive
  30. }
  31. // only a whitelist of value types can be observed.
  32. // 检查目标对象是否能被观察, 不能直接返回
  33. if (!canObserve(target)) {
  34. return target
  35. }
  36. // 使用 Proxy 创建 observe
  37. const observed = new Proxy(
  38. target,
  39. collectionTypes.has(target.constructor) ? collectionHandlers : baseHandlers
  40. )
  41. // 打上相应标记
  42. def(
  43. target,
  44. isReadonly ? ReactiveFlags.readonly : ReactiveFlags.reactive,
  45. observed
  46. )
  47. return observed
  48. }
  49. // 同时满足3个条即为可以观察的目标对象
  50. // 1. 没有打上__v_skip标记
  51. // 2. 是可以观察的值类型
  52. // 3. 没有被frozen
  53. const canObserve = (value: Target): boolean => {
  54. return (
  55. !value.__v_skip &&
  56. isObservableType(toRawType(value)) &&
  57. !Object.isFrozen(value)
  58. )
  59. }
  60. // 可以被观察的值类型
  61. const isObservableType = /*#__PURE__*/ makeMap(
  62. 'Object,Array,Map,Set,WeakMap,WeakSet'
  63. )

结语

看到这里我们大概清楚 reactive 是做为整个响应式的入口,负责处理目标对象是否可观察以及是否已被观察的逻辑,最后使用 Proxy 进行目标对象的代理,对 es6 Proxy 概念清楚的同学应该 Proxy 重点的逻辑处理在 Handlers , 接下来我们就一起去看看各种 Handlers

如果你对 Proxy 还不理解,可以点这里学习