submitFailed

SubmitFailed is a term used in some form state management libraries to denote that an attempt to submit a form has failed. It is not a browser standard, and its presence, name, and exact semantics vary between frameworks. In general, submitFailed is a boolean flag that becomes true after a user submits a form and the submission does not complete successfully, either due to client-side validation errors or a server-side error response.

When submitFailed is set, the user interface typically responds by highlighting invalid fields, displaying error messages, and sometimes focusing the first failing control. The flag is often used in conjunction with other state indicators such as isSubmitting, isSubmitted, and submitCount to control validation feedback timing and to prevent repeated submissions.

Resetting the flag is usually tied to form changes or new submission attempts. It is commonly cleared when the user makes changes to the form (marking fields as dirty again) or when a subsequent submission succeeds. In some implementations, submitFailed is cleared only after a successful submission or when the form is reset.

Notes: Because submitFailed is not standardized, developers should refer to the documentation of their specific framework or library to understand how it is set, how it interacts with onSubmit and onSubmitFailed handlers, and how it should be reset. Common sources that use or emulate this flag include form libraries across React, Vue, and Angular ecosystems, but naming and exact behavior can differ.