vize:croquis/cf/toraw-mutation
toRaw is used and the raw object is then mutated.
Default severity: Not emitted
Applies to: Analyzed component graph and the supported facts described below
Automatic fix: None; review related files and apply the repair
Options: No per-code options; supported CLI findings accept severity overrides
This is a published diagnostic contract without a current producer. The Bad/Good scenario below explains the risk and repair; no flag currently makes this code trigger.
Shared project files
Use these unchanged files in both Bad and Good. Install the imported packages in the project: Vue, plus vue-router or Pinia where shown. Follow any version-specific support note. The entry root makes the component relationship explicit.
main.ts
import { createApp } from 'vue';
import App from './App.vue';
createApp(App).mount('#app');
index.html
<!doctype html>
<html lang="en"><head><meta charset="UTF-8"><title>Contract scenario</title></head>
<body><div id="app"></div><script type="module" src="/main.ts"></script></body></html>
App.vue
<script setup lang="ts">
import { makeProfile, rename } from './profile';
const profile = makeProfile();
</script>
<template>
<p>{{ profile.name }}</p><button @click="rename(profile)">Rename</button>
</template>
Bad
rename obtains the raw target and writes raw.name, bypassing the proxy setter that would notify the displayed reactive name.
profile.ts
import { reactive, toRaw } from 'vue';
export function makeProfile() { return reactive({ name: 'Ada' }); }
export function rename(profile: { name: string }): void {
const raw = toRaw(profile);
raw.name = 'Grace';
}
Good
Writing profile.name through the passed reactive proxy preserves the same rename while notifying its dependents.
profile.ts
import { reactive } from 'vue';
export function makeProfile() { return reactive({ name: 'Ada' }); }
export function rename(profile: { name: string }): void {
profile.name = 'Grace';
}
The Good files demonstrate the change described above; other diagnostics can still apply to the complete project.