Field-level `onMount` errors are never cleared on linked-field revalidation

Abierto
#2,124 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
52/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
react, typescript
Área
frontend

Línea de trabajo

Comienza con el flujo de revalidación de campos vinculados en la reproducción de StackBlitz, centrándote en onMount, onChangeListenTo, errorMap y la validez del estado del campo. Confirma que cambiar password revalida correctamente confirmPassword; se considera terminado cuando se elimina el error obsoleto de onMount y tanto field.isValid como form.isValid pasan a ser true sin tocar confirmPassword.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

v1 v2: needs investigation
Describe the bug

When a field has a field-level onMount validator and is linked to another field, the onMount error is never cleared, even when the other validators on that field run successfully via the linked-field mechanism and report the field as valid.

The result is that field.state.meta.errors keeps surfacing the stale mount-time error and isValid stays false indefinitely or until you touch the field. This also propagates to form.state.isValid, breaking submit-button enablement and any UI that depends on per-field validity.

Possibly related to #689, #903

Your minimal, reproducible example

https://stackblitz.com/edit/vitejs-vite-ywiic5qt?file=src%2FApp.tsx

Steps to reproduce
  1. Open the StackBlitz repro.
  2. Observe the initial state: password is empty, confirmPassword defaults to "password". The confirmPassword field's onMount validator correctly reports "Passwords do not match" in errorMap.onMount, and isValid is false. This is expected.
  3. Type "password" into the Password input. Do not touch the Confirm Password input.
  4. The onChange validator on confirmPassword runs via onChangeListenTo: ["password"] and correctly returns undefined — errorMap.onChange is now undefined.
  5. Bug: errorMap.onMount still shows "Passwords do not match", and both confirmPassword.isValid and form.isValid remain false, even though both validators on the field, given the current values, return undefined.
Expected behavior

As a user, I expected the onMount error to clear once the field's other validators run successfully via the linked-field mechanism, but I am seeing the onMount error persist indefinitely (or until it's touched), leaving the field marked as invalid even though all of its validators agree that it is valid.

How often does this bug happen?

Every time

Platform
  • OS: macOS
  • Browser: Google Chrome
  • Version: 146.0.7680.178
TanStack Form adapter

react-form

TanStack Form version

v.1.29.0

TypeScript version

v6.0.2

Additional context

Not sure whether to classify this as a bug or a design choice. onMount only clearing on direct value changes could be a deliberate "the user must acknowledge this field" rule. But it does feel like an edge case worth revisiting, given that onChangeListenTo / onBlurListenTo exist specifically for cross-field patterns.

If the current behavior is intentional, an opt-in to let successful linked-field revalidation clear the stale onMount slot would be very helpful. The only workaround I've found is to manually clear the slot via setMeta from a listener on the source field, which is fragile and easy to forget.

Lenguaje dominante
TypeScript
Estrellas
6.7k
Forks
682
Merge medio
5 d 18 h
PR fusionados (30 d)
7

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de TanStack/form

Todos los issues de TanStack/form

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.