Enum ValidationError 

pub enum ValidationError {
    ExtractionError {
        message: String,
        is_htmx: bool,
    },
    ValidationError {
        errors: ValidationErrors,
        is_htmx: bool,
    },
}

Error type returned by ValidatedForm and ValidatedJson extractors. Automatically renders HTMX-friendly HTML error components for HTMX requests, or standard JSON 422/400 responses for REST clients.

HTMX 1.x and 2.x swap only successful responses by default, so an HTMX request (HX-Request: true) receives the fragment with 200 OK and the X-Rullst-Validation-Status header set to the 400 or 422 a REST client would receive. htmx swaps it into the request’s hx-target with its hx-swap; client scripts can read that header to tell a validation failure from success.

Every message, field name and validator message is HTML-escaped before it is placed in the HTMX fragment. The built-in extractors never copy the deserializer’s error text (which can echo request input) into ValidationError::ExtractionError; they use a fixed message chosen from the rejection’s status and log the detail server-side at debug level on the rullst::validation target.

Variants

ExtractionError

A deserialization error occurred before validation could run (e.g. malformed JSON body).

Fields

message: String

Human-readable description of the extraction failure.

is_htmx: bool

true if the request was triggered by HTMX (HX-Request: true header present).

ValidationError

The payload was extracted successfully but failed validator::Validate constraints.

Fields

errors: ValidationErrors

The set of field-level validation errors returned by the validator crate.

is_htmx: bool

true if the request was triggered by HTMX (HX-Request: true header present).

Trait Implementations

impl Debug for ValidationError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ValidationError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ValidationError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl IntoResponse for ValidationError

fn into_response(self) -> Response

Create a response.