PlexErrorType enum

Semantic categories for failures coming out of PlexClient.

Used by PlexException.type so callers can decide whether to retry, re-authenticate, or surface the error to the user.

Inheritance
Available extensions

Values

connection → const PlexErrorType

Transport-level failure (DNS resolution, TCP reset, broken pipe, no route to host). Usually retriable after a backoff.

timeout → const PlexErrorType

The request did not complete within the configured timeout.

auth → const PlexErrorType

The server replied with 401 Unauthorized / 403 Forbidden, or the PIN flow returned an authToken-less response past its expiresAt. Callers should re-run the PIN/sign-in flow.

notFound → const PlexErrorType

The server replied with 404 Not Found — the resource (rating key, playlist, section) does not exist on this server.

badRequest → const PlexErrorType

The server replied with a 4xx other than 401/403/404.

serverError → const PlexErrorType

The server replied with 5xx.

parse → const PlexErrorType

The response body could not be decoded (invalid JSON, missing MediaContainer, unexpected schema).

state → const PlexErrorType

A precondition for the call was not met locally (e.g. calling a PMS endpoint before PlexClient.connect).

cancelled → const PlexErrorType

The request was cancelled by the caller via a CancelToken before it completed. Not an error condition — distinct from unknown so callers can ignore cancellations instead of logging them as failures.

unknown → const PlexErrorType

Anything else.

Properties

hashCode → int
The hash code for this object.
no setterinherited
index → int
A numeric identifier for the enumerated value.
no setterinherited
isAuthError → bool
Whether the error means the saved token is no longer valid.
no setter
isRetriable → bool
Whether the error is likely to succeed on retry.
no setter
name → String

Available on Enum, provided by the EnumName extension

The name of the enum value.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

fromHttpStatus(int status) → PlexErrorType
Classify an HTTP status code.

Constants

values → const List<PlexErrorType>
A constant List of the values in this enum, in order of their declaration.