【Vue3 源码解析】reactive 全家桶

// 泛型约束：只能传入引用类型
export function reactive<T extends object>(target: T): UnwrapNestedRefs<T>
// 判断只读，否则创建reactive响应式对象
export function reactive(target: object) {
  // if trying to observe a readonly proxy, return the readonly version.
  if (isReadonly(target)) {
    return target
  }
  return createReactiveObject(
    target,
    false,
    mutableHandlers,
    mutableCollectionHandlers,
    reactiveMap
  )
}

这段代码是 Vue 3 中的 reactive 函数的实现部分，它用于将一个对象转化为深度响应式代理对象。下面是这段代码的详细解释：

1. 函数签名：

   • function reactive<T extends object>(target: T): UnwrapNestedRefs<T>：这是 reactive 函数的类型签名，它接受一个泛型参数 T，表示目标对象的类型，并返回一个与目标对象类型相同的深度响应式代理对象。UnwrapNestedRefs<T> 类型用于解包嵌套的 Ref，以获得原始值。

   • function reactive(target: object)：这是 reactive 函数的实际实现。

2. 实现逻辑：

   • 首先，函数检查目标对象 target 是否已经被标记为只读（readonly）。如果是只读的，就直接返回目标对象本身，因为只读对象不应该被转化为响应式对象。

   • 如果目标对象不是只读的，那么就调用 createReactiveObject 函数来创建深度响应式代理对象。这里传递了一些参数：

     • target：要代理的目标对象。
     • false：表示不是只读的，即要创建可修改的代理对象。
     • mutableHandlers：处理深度响应式代理对象属性变化的处理器集合。
     • mutableCollectionHandlers：处理集合类型属性变化的处理器集合。
     • reactiveMap：WeakMap，用于存储对象和它们的响应式代理之间的映射关系。

3. 总结：

   • 这段代码实现了 reactive 函数的核心逻辑，它负责创建一个深度响应式代理对象，该对象能够追踪目标对象属性的变化，并在变化时通知相关视图进行更新。如果目标对象已经是只读对象，那么函数不会再对其进行代理，而是直接返回只读对象本身。

function createReactiveObject(
  target: Target,
  isReadonly: boolean,
  baseHandlers: ProxyHandler<any>,
  collectionHandlers: ProxyHandler<any>,
  proxyMap: WeakMap<Target, any>
  //WeakMap的 键 只能是一个object类型的数据，并且WeakMap的键名所指向的对象，不计入垃圾回收机制
  //它的键名所引用的对象都是弱引用，即垃圾回收机制不将该引用考虑在内。
  //因此，只要所引用的对象的其他引用都被清除，垃圾回收机制就会释放该对象所占用的内存。
  //也就是说，一旦不再需要，WeakMap里面的键名对象和所对应的键值对会自动消失，不用手动删除引用
) {
  // 如果传入的是普通的基本数据类型
  if (!isObject(target)) {
    if (__DEV__) {
      console.warn(`value cannot be made reactive: ${String(target)}`)
    }
    return target
  }
  // target is already a Proxy, return it.
  // exception: calling readonly() on a reactive object
  // target 已经被代理过，并且不是为了将响应式对象变为只读，则直接返回
  if (
    target[ReactiveFlags.RAW] &&
    !(isReadonly && target[ReactiveFlags.IS_REACTIVE])
  ) {
    return target
  }
  // target already has corresponding Proxy
  // 从缓存（readonlyMap，reactiveMap）中查找，如果已经被代理过则直接返回
  const existingProxy = proxyMap.get(target)
  if (existingProxy) {
    return existingProxy
  }
  // only specific value types can be observed.
  // 如果在白名单直接返回 例如 __skip__
  const targetType = getTargetType(target)
  if (targetType === TargetType.INVALID) {
    return target
  }
  // 如果以上条件都没触发，则会进行一个proxy代理
  const proxy = new Proxy(
    target,
    targetType === TargetType.COLLECTION ? collectionHandlers : baseHandlers
  )
  // 缓存新代理后的对象
  proxyMap.set(target, proxy)
  return proxy
}

这段代码是 Vue 3 中用于创建响应式代理对象的核心逻辑，它实现了 createReactiveObject 函数。下面是这段代码的详细解释：

1. 函数签名：

   • function createReactiveObject(target: Target, isReadonly: boolean, baseHandlers: ProxyHandler<any>, collectionHandlers: ProxyHandler<any>, proxyMap: WeakMap<Target, any>)：这是 createReactiveObject 函数的类型签名。它接受以下参数：
     • target：要代理的目标对象。
     • isReadonly：一个布尔值，表示是否要创建只读的代理对象。
     • baseHandlers：一个处理常规对象属性变化的处理器集合。
     • collectionHandlers：一个处理集合对象属性变化的处理器集合。
     • proxyMap：一个 WeakMap，用于存储对象与它们的代理之间的映射关系。

2. 实现逻辑：

   • 首先，函数会检查 target 是否是一个普通的基本数据类型，如果是，会在开发环境下发出警告，并返回 target 本身。这是为了确保只有对象才会被代理，基本数据类型不会被代理。

   • 接着，函数检查 target 是否已经被代理过，如果是并且不是为了将响应式对象变成只读的（即 isReadonly 为 false），则直接返回 target 本身。这是一种性能优化，避免重复代理已经被代理过的对象。

   • 如果 target 还没有被代理过，函数会继续进行以下操作：

     • 调用 getTargetType 函数，该函数根据目标对象的类型，返回一个值，指示目标对象的类型。具体来说，如果 target 是普通对象或数组，它会返回 TargetType.COMMON；如果是集合对象（如 Map、Set 等），则返回 TargetType.COLLECTION；否则，返回 TargetType.INVALID。

     • 如果 targetType 是 TargetType.INVALID，则说明 target 的类型不在白名单中，不能被代理，直接返回 target 本身。

     • 最后，使用 new Proxy 创建一个代理对象 proxy，并根据 targetType 选择相应的处理器集合（baseHandlers 或 collectionHandlers）来处理属性的变化。然后，将 proxy 缓存到 proxyMap 中，以便下次再次代理相同的 target 时可以直接返回缓存的 proxy。

3. 总结：

   • createReactiveObject 是 Vue 3 响应式系统的核心函数之一，它用于创建深度响应式代理对象。函数会检查目标对象是否已经被代理过，如果已经被代理则直接返回，避免不必要的重复代理。如果目标对象是在白名单中的可代理类型，那么就创建一个代理对象，并将其缓存，以便后续使用。