標記一個對象,使其永遠不會轉換為代理。返回對象本身。
類型
function markRaw<T extends object>(value: T): T
示例
const foo = markRaw({})
console.log(isReactive(reactive(foo))) // false
// also works when nested inside other reactive objects
const bar = reactive({ foo })
console.log(isReactive(bar.foo)) // false
謹慎使用
markRaw()
和 shallowReactive()
等淺層 API 允許您有選擇地 opt-out 進行默認的深度反應/隻讀轉換,並在狀態圖中嵌入原始的非代理對象。它們可以用於多種原因:
有些值根本不應該是被動的,例如複雜的 3rd 方類實例或 Vue 組件對象。
在呈現具有不可變數據源的大型列表時,跳過代理轉換可以提高性能。
它們被認為是高級的,因為原始 opt-out 僅位於根級別,因此如果您將嵌套的、未標記的原始對象設置為反應性對象,然後再次訪問它,您將獲得代理版本。這可能會導致身份風險——即執行依賴於對象身份但同時使用同一對象的原始版本和代理版本的操作:
const foo = markRaw({
nested: {}
})
const bar = reactive({
// although `foo` is marked as raw, foo.nested is not.
nested: foo.nested
})
console.log(foo.nested === bar.nested) // false
身份風險通常很少見。但是,要正確使用這些 API,同時安全地避免身份危害,需要對反應係統的工作原理有深入的了解。
相關用法
- Vue.js mergeProps()用法及代碼示例
- Vue.js mixins用法及代碼示例
- Vue.js methods用法及代碼示例
- Vue.js useSSRContext()用法及代碼示例
- Vue.js app.directive()用法及代碼示例
- Vue.js app.config.warnHandler用法及代碼示例
- Vue.js pipeToWebWritable()用法及代碼示例
- Vue.js app.use()用法及代碼示例
- Vue.js v-pre用法及代碼示例
- Vue.js h()用法及代碼示例
- Vue.js serverPrefetch用法及代碼示例
- Vue.js customRef()用法及代碼示例
- Vue.js <Transition>用法及代碼示例
- Vue.js inject()用法及代碼示例
- Vue.js ComponentCustomProps用法及代碼示例
- Vue.js reactive()用法及代碼示例
- Vue.js ComponentCustomProperties用法及代碼示例
- Vue.js app.mount()用法及代碼示例
- Vue.js <component>用法及代碼示例
- Vue.js createRenderer()用法及代碼示例
- Vue.js onMounted()用法及代碼示例
- Vue.js createApp()用法及代碼示例
- Vue.js app.config.errorHandler用法及代碼示例
- Vue.js v-on用法及代碼示例
- Vue.js components用法及代碼示例
注:本文由純淨天空篩選整理自vuejs.org大神的英文原創作品 markRaw()。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。