`z.union` errors surface under `""` key instead of field-level errors

Ouverte
#2,081 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

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

Personne n'a encore pris cette issue.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
42/100
Type d'issue
Bug
Clarté
Plutôt claire
Activité
À l'abandon
Stack technique
typescript
Domaine
frontend

Piste de recherche

Commencez par la reproduction minimale dans src/index.tsx de StackBlitz, puis suivez comment l’erreur invalid_union avec un chemin vide devient la clé "" dans fieldErrors. Comparez le mapping observé au comportement attendu au niveau du champ ou à celui d’une erreur racine, et ajoutez une couverture pour le cas z.union reproduit.

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

Description

v1 v2: needs investigation
Describe the bug

Body:

When using a Zod z.union as a form schema, validation failures produce an invalid_union error with path: [] (root). TanStack Form maps this to the "" (empty string) key in fieldErrors, making it impossible to associate the error with any specific field.

Repro:

const schema = z.union([
  z.object({ firstName: z.string().min(1), lastName: z.string().min(1) }),
  z.object({ email: z.string() }),
]);
// On failure: fieldErrors = { "": ["Invalid input"] }
Your minimal, reproducible example

https://stackblitz.com/edit/tanstack-form-zcs7lghv?file=src%2Findex.tsx&preset=node

Steps to reproduce

submit + inspect console.logs

Expected behavior

errors should surface on the relevant fields, or there should be a supported way to map root-level union errors to specific field paths.

How often does this bug happen?

None

Screenshots or Videos

No response

Platform

any

TanStack Form adapter

None

TanStack Form version

1.28.5

TypeScript version

No response

Additional context

No response

Langage dominant
TypeScript
Étoiles
6.8k
Forks
717
Merge moyen
5 j 22 h
PR mergées (30 j)
14

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 TanStack/form

Toutes les issues de TanStack/form

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.