Vize

vue/no-mutating-props

Interdire la modification des props d’un composant.

Gravité par défaut Préréglages Correction automatique Options
error essential, happy-path, nuxt, ecosystem, opinionated Non Options des règles

Champ d’application : Templates et blocs des SFC Vue, avec le contexte du script requis par la règle.

Une assertion de type ne change pas la valeur qu’elle encadre : dans un template, (rows as string[]).push(x) et rows!.push(x) sont donc signalés comme des mutations de la prop rows, alors qu’eslint-plugin-vue s’arrête à l’assertion.

Mauvais

Incrémenter props.count modifie directement une valeur fournie par le parent.

<script setup lang="ts">
const props = defineProps<{ count: number }>();

props.count++;
</script>

Bon

Le composant émet update:count avec la nouvelle valeur et laisse au parent la responsabilité de mettre à jour la prop.

<script setup lang="ts">
const props = defineProps<{ count: number }>();
const emit = defineEmits<{ "update:count": [value: number] }>();

function increment() {
  emit("update:count", props.count + 1);
}
</script>

Configuration (Vite+)

import { defineConfig } from "@vizejs/vite-plugin/vite-plus";

export default defineConfig({}).withVue({
  linter: {
    "preset": "incremental",
    "rules": {
      "vue/no-mutating-props": "error"
    }
  },
});

Lancez ensuite vp run lint.

Voir aussi