Hydration hint false positive: `class=""` appears on dynamic components with an undefined class

Ouverte Adaptée aux débutants
#409 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@lafllamme y travaille déjà.

Depuis le 12/11/2026.

  • #412 par @lafllamme — ouverte

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
76/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
nuxt, typescript
Domaine
frontend, testing

Piste de recherche

Commencez par lire l’implémentation de normalizeHTMLForComparison et les tests de régression existants pour les issues #351 et #352 ; l’issue indique que cette normalisation est le point à modifier. Reproduisez le cas du composant dynamique avec une classe non définie et comparez le HTML avant et après l’hydratation. Le travail est terminé lorsque les attributs class et style vides sont normalisés avant la comparaison et que ce cas ne produit plus de faux avertissement.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

Environment
  • nuxt 4.6.2 (SSR, dev mode)
  • @nuxt/hints 1.1.5
  • vue 3.5.44
  • @nuxt/ui 4.12.0 (where I first hit it; not needed to reproduce)
  • Node.js 26.13.0, Windows 11
Reproduction

A component on any SSR page, components/EmptyClass.vue:

<script setup lang="ts">
const tag = ref('div')
const noClass = undefined
</script>

<template>
  <component :is="tag" :class="noClass">
    content
  </component>
</template>

The same happens with Nuxt UI's <UForm> without a class prop: its root is a <component :is> and its computed class is undefined.

Describe the bug

@nuxt/hints warns about a hydration difference whose only content is an empty class attribute:

- <div>
+ <div class="">

Vue itself reports no hydration mismatch.

Controls I tried:

  • the same with :class="''": the server also renders class="", no warning;
  • a plain <div :class="noClass">: neither side has the attribute, no warning.

Why it happens:

  • SSR renders an undefined class as no attribute.
  • On the client, the compiled render wraps the binding in normalizeClass(), which turns undefined into ''.
  • Because the element is a dynamic component, class is among the vnode's dynamicProps, and hydrateElement patches every dynamic prop during hydration.
  • patchClass(el, '') then sets el.className = '', which creates class="".
  • Vue's own propHasMismatch treats a missing class as "", so it sees no mismatch.
  • useHydrationCheck compares raw outerHTML and only normalizes style.

Expected: no warning, since class="" and no class attribute are equivalent (and Vue agrees).

Suggestion: extend the normalization from #352 and drop empty class="" (and style="") attributes in normalizeHTMLForComparison before comparing.

Additional context

Same class of false positive as #351 (fixed in #352 for style serialization), and a concrete case of "make attribute comparison more precise" in #257.

Logs
[hydration] Component EmptyClass at .../components/EmptyClass.vue seems to have different html pre and post-hydration. Please make sure you don't have any hydration issue.
Langage dominant
TypeScript
Étoiles
347
Forks
15
Merge moyen
7 min
PR mergées (30 j)
1

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de nuxt/hints

Toutes les issues de nuxt/hints

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.