Enum ImportKeyError

pub enum ImportKeyError {
    Syntax,
    Type,
    InvalidKeyFormat,
    Generic(Error),
}

Errors that can occur when importing cryptographic keys.

These errors map to the exceptions defined in the Web Crypto API specification for key import operations.

See MDN Documentation

Variants

Syntax

Indicates that the key usage array is empty for a secret or private key.

This error occurs when:

• No key usages are specified during import
• The key type requires at least one usage to be specified

Key usages typically include operations like “encrypt”, “decrypt”, “sign”, or “verify”.

Type

Indicates that the key data is not suitable for the specified format.

This error occurs when:

• The key data is malformed
• The key data doesn’t match the expected format
• The key data is invalid for the specified algorithm

For example, trying to import non-AES data as an AES key would trigger this error.

InvalidKeyFormat

Indicates that an invalid key format was specified during import.

This error occurs when:

• The specified format (e.g., “raw”, “pkcs8”, “spki”, “jwk”) is not supported
• The specified format is not appropriate for the key type

For example, trying to import a symmetric key using “spki” format would trigger this error.

Generic(Error)

A wrapper for other types of errors that may occur during key import.

This includes general Web Crypto API errors and other unexpected failures.

Trait Implementations

impl Clone for ImportKeyError

fn clone(&self) -> ImportKeyError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ImportKeyError

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

Formats the value using the given formatter.

impl Display for ImportKeyError

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

Formats the value using the given formatter.

impl Error for ImportKeyError

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 ImportKeyError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JsValue> for ImportKeyError

fn from(value: JsValue) -> Self

Converts a JavaScript value into an ImportKeyError.

Maps specific DOM exceptions to their corresponding ImportKeyError variants:

• SyntaxError → ImportKeyError::Syntax
• DataError → ImportKeyError::InvalidKeyFormat
• JavaScript SyntaxError → ImportKeyError::Type
• Other errors → ImportKeyError::Generic

Arguments

• value - The JavaScript value to convert

Returns

The corresponding ImportKeyError variant