Struct ValidationErrors 

pub struct ValidationErrors {
    pub errors: Vec<ValidationError>,
    pub body: Option<Value>,
    pub debug_info: Option<DebugInfo>,
}

Collection of validation errors (422 Unprocessable Entity response).

This collects multiple validation errors from extractors and validators, producing a FastAPI-compatible error response format.

Examples

use fastapi_core::error::{ValidationErrors, ValidationError, loc, error_types};
use serde_json::json;

let mut errors = ValidationErrors::new();

// Add multiple errors
errors.push(ValidationError::missing(loc::query("q")));
errors.push(ValidationError::string_too_short(loc::body_field("name"), 3)
    .with_input(json!("ab")));

// Check and convert
if !errors.is_empty() {
    let json = errors.to_json();
    assert!(json.contains("missing"));
}

Fields

errors: Vec<ValidationError>

The collected errors.

body: Option<Value>

The original input body (if available).

debug_info: Option<DebugInfo>

Debug information (only included in response when debug mode is enabled).

Implementations

impl ValidationErrors

pub fn new() -> ValidationErrors

Create empty validation errors.

pub fn single(error: ValidationError) -> ValidationErrors

Create from a single error.

pub fn from_errors(errors: Vec<ValidationError>) -> ValidationErrors

Create from multiple errors.

pub fn push(&mut self, error: ValidationError)

Add an error.

pub fn extend(&mut self, errors: impl IntoIterator<Item = ValidationError>)

Add multiple errors.

pub fn with_body(self, body: Value) -> ValidationErrors

Set the original body that failed validation.

pub fn with_debug_info(self, debug_info: DebugInfo) -> ValidationErrors

Add debug information.

This information will only be included in the response when debug mode is enabled (via enable_debug_mode()).

pub fn is_empty(&self) -> bool

Check if there are any errors.

pub fn len(&self) -> usize

Get the number of errors.

pub fn iter(&self) -> impl Iterator<Item = &ValidationError>

Get an iterator over the errors.

pub fn to_json(&self) -> String

Convert to FastAPI-compatible JSON string.

pub fn to_json_bytes(&self) -> Vec<u8>

Convert to JSON bytes.

pub fn merge(&mut self, other: ValidationErrors)

Merge another ValidationErrors into this one.

pub fn with_loc_prefix(self, prefix: Vec<LocItem>) -> ValidationErrors

Add a prefix to all error locations.

Trait Implementations

impl Clone for ValidationErrors

fn clone(&self) -> ValidationErrors

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ValidationErrors

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

Formats the value using the given formatter.

impl Default for ValidationErrors

fn default() -> ValidationErrors

Returns the “default value” for a type.

impl Display for ValidationErrors

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

Formats the value using the given formatter.

impl Error for ValidationErrors

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 Extend<ValidationError> for ValidationErrors

fn extend<T>(&mut self, iter: T)

where T: IntoIterator<Item = ValidationError>,

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl FromIterator<ValidationError> for ValidationErrors

fn from_iter<T>(iter: T) -> ValidationErrors

where T: IntoIterator<Item = ValidationError>,

Creates a value from an iterator.

impl<'a> IntoIterator for &'a ValidationErrors

type Item = &'a ValidationError

The type of the elements being iterated over.

type IntoIter = Iter<'a, ValidationError>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a ValidationErrors as IntoIterator>::IntoIter

Creates an iterator from a value.

impl IntoIterator for ValidationErrors

type Item = ValidationError

The type of the elements being iterated over.

type IntoIter = IntoIter<ValidationError>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <ValidationErrors as IntoIterator>::IntoIter

Creates an iterator from a value.

impl IntoResponse for ValidationErrors

fn into_response(self) -> Response

Convert into a response.