Enum NonceError

pub enum NonceError {
    QuotaExceeded,
    InvalidSize {
        expected: u32,
        received: u32,
    },
    Generic(Error),
}

Errors that can occur during nonce (number used once) operations.

These errors handle both Web Crypto API random generation errors and nonce validation errors.

See MDN Documentation

Variants

QuotaExceeded

Indicates that the requested nonce length exceeds the maximum allowed size.

This error occurs when trying to generate a nonce larger than 65536 bytes, which is the maximum size allowed by the Web Crypto API’s getRandomValues(). This limit exists as a security measure to prevent excessive entropy extraction.

Note: Most cryptographic algorithms use much smaller nonces (typically 12 or 16 bytes), so this error should rarely occur in practice.

InvalidSize

Indicates that the provided nonce size doesn’t match the algorithm’s requirements.

This error occurs when:

• Creating a nonce from existing data
• The provided data length doesn’t match the algorithm’s specified nonce size

Fields

• expected - The nonce size required by the algorithm
• received - The actual size of the provided nonce data

For example, if AES-GCM requires a 12-byte nonce but 16 bytes were provided, this error would be returned with expected=12, received=16.

Fields

expected: u32

received: u32

Generic(Error)

A wrapper for other types of errors that may occur during nonce operations.

This includes general Web Crypto API errors and other unexpected failures that might occur during nonce generation or handling.

Trait Implementations

impl Clone for NonceError

fn clone(&self) -> NonceError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NonceError

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

Formats the value using the given formatter.

impl Display for NonceError

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

Formats the value using the given formatter.

impl Error for NonceError

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<Error> for NonceError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JsValue> for NonceError

fn from(value: JsValue) -> Self

Converts to this type from the input type.