Enum fxa_client::FxaError

pub enum FxaError {
    Authentication,
    Network,
    NoExistingAuthFlow,
    WrongAuthFlow,
    OriginMismatch,
    SyncScopedKeyMissingInServerResponse,
    Panic,
    Other(String),
}

Public error type thrown by many [FirefoxAccount] operations.

Precise details of the error are hidden from consumers. The type of the error indicates how the calling code should respond.

Variants

Authentication

Thrown when there was a problem with the authentication status of the account, such as an expired token. The application should check its authorization status to see whether it has been disconnected, or retry the operation with a freshly-generated token.

Network

Thrown if an operation fails due to network access problems. The application may retry at a later time once connectivity is restored.

NoExistingAuthFlow

Thrown if the application attempts to complete an OAuth flow when no OAuth flow has been initiated. This may indicate a user who navigated directly to the OAuth redirect_uri for the application.

Note: This error is currently only thrown in the Swift language bindings.

WrongAuthFlow

Thrown if the application attempts to complete an OAuth flow, but the state tokens returned from the Firefox Account server do not match with the ones expected by the client. This may indicate a stale OAuth flow, or potentially an attempted hijacking of the flow by an attacker. The signin attempt cannot be completed.

Note: This error is currently only thrown in the Swift language bindings.

OriginMismatch

Origin mismatch when handling a pairing flow

The most likely cause of this is that a user tried to pair together two firefox instances that are configured to use different servers.

SyncScopedKeyMissingInServerResponse

A scoped key was missing in the server response when requesting the OLD_SYNC scope.

Panic

Thrown if there is a panic in the underlying Rust code.

Note: This error is currently only thrown in the Kotlin language bindings.

Other(String)

A catch-all for other unspecified errors.

Trait Implementations

impl Debug for FxaError

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

Formats the value using the given formatter.

impl Display for FxaError

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

Formats the value using the given formatter.

impl Error for FxaError

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

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.