首页 / 知识

Vue3.0API介绍中 markRaw 使用示例

2023-04-11 13:23:00

markRaw

标记一个对象，使其永远不会转换为 proxy。返回对象本身。

import { markRaw, reactive, isReactive } from "vue";

const foo = markRaw({})

console.log(isReactive(reactive(foo))) // false

// 嵌套在其他响应式对象中时也可以使用

const bar = reactive({ foo })

console.log(isReactive(bar.foo)) // false

</script>

重要

markRaw 和下方的 shallowXXX API 使你可以有选择地退出默认的深度响应式/只读转换模式，并将原始的，未被代理的对象嵌入状态图中。它们可以根据情况灵活运用：

有些值不应该是响应式的，例如复杂的第三方类实例或 Vue 组件对象。

当渲染具有不可变数据源的大列表时，跳过 proxy 转换可以提高性能。

这些例子是进阶的运用，因为原始选择退出仅在根级别，因此，如果将嵌套在内的、未标记的原始对象添加进响应式对象，然后再次访问该响应式对象，就会得到原始对象被代理后的版本。这可能会导致同一性风险——即执行一个依赖于对象本身的操作，但同时使用同一对象的原始版本和被代理后的版本：

import { markRaw, reactive, isReactive } from "vue";

const foo = markRaw({

nested: {}

})

const bar = reactive({

// 虽然 `foo` 被标记为原始，但 foo.nested 不是。

nested: foo.nested

})

console.log(foo.nested === bar.nested) // false

</script>

同一性风险通常很少见。然而，为了正确地使用这些 API，同时安全地避免同一性风险，就需要对响应性系统的工作原理有一个充分的理解。