Struct Errors 

pub struct Errors { /* private fields */ }

The messages a failed validation produced, grouped by field.

wants_json is captured when the errors are built from a request, because IntoResponse::into_response no longer has the request to negotiate with.

Implementations

impl Errors

pub const STATUS: Status = Status::UNPROCESSABLE

The status a failed validation answers with.

pub fn new() -> Self

pub fn add(&mut self, field: impl Into<String>, message: impl Into<String>)

pub fn has(&self, field: &str) -> bool

pub fn first(&self, field: &str) -> Option<&str>

The first message for a field — what a form renders next to the input.

pub fn get(&self, field: &str) -> &[String]

Every message for one field.

pub fn all(&self) -> &BTreeMap<String, Vec<String>>

Every message for every field, keyed by field name.

pub fn messages(&self) -> impl Iterator<Item = &str>

Every message, flattened, in field order.

pub fn is_empty(&self) -> bool

pub fn len(&self) -> usize

The number of messages, not the number of fields — one field can fail several rules.

pub fn fields(&self) -> impl Iterator<Item = &str>

pub fn wants_json(&self) -> bool

Whether the response should be JSON. Set from Request::wants_json.

pub fn with_json(self, wants_json: bool) -> Self

pub fn with(self, field: impl Into<String>, message: impl Into<String>) -> Self

Add a message by hand, chaining — useful for a rule an application enforces itself, so its failure comes back in the same envelope as the built-in ones.

pub fn add_interpolated( &mut self, messages: &Messages, field: &str, template: &str, )

Render a hand-written message through the message bag’s label rules, so it interpolates :attribute the way a built-in one does.

pub fn summary(&self) -> String

The single-line summary Laravel puts in the message key: the first failure, and a count of the rest so a client that only shows one line still tells the user there is more to fix.

pub fn to_json(&self) -> Json

The Laravel-shaped 422 body.

Trait Implementations

impl Clone for Errors

fn clone(&self) -> Errors

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Errors

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

Formats the value using the given formatter.

impl Default for Errors

fn default() -> Errors

Returns the “default value” for a type.

impl Display for Errors

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

Formats the value using the given formatter.

impl Error for Errors

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 From<&Errors> for Json

fn from(errors: &Errors) -> Self

Converts to this type from the input type.

impl From<Errors> for Json

fn from(errors: Errors) -> Self

Converts to this type from the input type.

impl From<Errors> for Response

fn from(errors: Errors) -> Self

Converts to this type from the input type.

impl IntoResponse for Errors

A 422, as JSON for an API client and as plain text for a browser.

The HTML side is intentionally minimal for now: re-rendering the submitted form with the messages attached needs the view layer, which is a later phase.

fn into_response(self) -> Response

impl PartialEq for Errors

fn eq(&self, other: &Errors) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Errors