Hydration hint false positive: `class=""` appears on dynamic components with an undefined class
Les mainteneurs répondent en général sous 1 jour
É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
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 rendersclass="", 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 turnsundefinedinto''. - Because the element is a dynamic component,
classis among the vnode'sdynamicProps, andhydrateElementpatches every dynamic prop during hydration. patchClass(el, '')then setsel.className = '', which createsclass="".- Vue's own
propHasMismatchtreats a missing class as"", so it sees no mismatch. useHydrationCheckcompares rawouterHTMLand only normalizesstyle.
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
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de nuxt/hints
-
Hydration hint of a component with no name is rejected (400 Invalid payload) and surfaces as an unhandled errorPeut-être pris @lafllamme l’a pris il y a 6 jours. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
Les mainteneurs répondent en général sous 1 jour
-
`extendServerRpc` is deprecatedOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
Les mainteneurs répondent en général sous 1 jour
-
RefrenceError on start upOuverteneed reproduction
Difficulté 4/5 3-5 jours Accessibilité débutants 30/100
nuxt/hints#277 · 1 commentaire · 2 réactions ·
Les mainteneurs répondent en général sous 1 jour
-
Make hydration diff more precisePeut-être à nouveau libre @huang-julien l’a pris il y a 260 jours, et aucune pull request n’est ouverte. Ouverte
nuxt/hints#257 · 1 commentaire · 2 réactions · 1 personne assignée ·
Les mainteneurs répondent en général sous 1 jour
-
Assets Hints for improved performancePeut-être à nouveau libre @Baroshem l’a pris il y a 296 jours, et aucune pull request n’est ouverte. Ouverte
nuxt/hints#199 · 3 commentaires · 2 réactions · 1 personne assignée ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de nuxt/hints
Issues similaires
-
bug priority: low role: BE stage: now
Difficulté 2/5 1-3 heures Accessibilité débutants 86/100
ahmadrosid/nakama#2594 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
milind-soni/OpenMausBot#6495 ·
Les mainteneurs répondent en général sous 1 jour
-
Navigating the session tree adds the branch's prompts to Up-arrow history againPeut-être pris @acmerfight l’a pris aujourd’hui. Ouverteuntriaged
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
earendil-works/pi#12279 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
Les mainteneurs répondent en général sous 1 jour
-
approved documentation
Difficulté 1/5 Moins d'une heure Accessibilité débutants 89/100
vitest-dev/vitest#12015 · 4 commentaires ·
Les mainteneurs répondent en général sous 1 jour