Enum twilight_model::gateway::CloseCode

#[non_exhaustive]
#[repr(u16)]
pub enum CloseCode {
    UnknownError,
    UnknownOpcode,
    DecodeError,
    NotAuthenticated,
    AuthenticationFailed,
    AlreadyAuthenticated,
    InvalidSequence,
    RateLimited,
    SessionTimedOut,
    InvalidShard,
    ShardingRequired,
    InvalidApiVersion,
    InvalidIntents,
    DisallowedIntents,
}

Gateway close event codes.

See Discord Docs/Gateway Close Event Codes for more information.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

UnknownError

An unknown error occurred.

UnknownOpcode

An invalid opcode or payload for an opcode was sent.

DecodeError

An invalid payload was sent.

NotAuthenticated

A payload was sent prior to identifying.

AuthenticationFailed

An invalid token was sent when identifying.

AlreadyAuthenticated

Multiple identify payloads were sent.

InvalidSequence

An invalid sequence was sent for resuming.

RateLimited

Too many payloads were sent in a certain amount of time.

SessionTimedOut

The session timed out.

InvalidShard

An invalid shard was sent when identifying.

ShardingRequired

Sharding is required because there are too many guilds.

InvalidApiVersion

An invalid version for the gateway was sent.

InvalidIntents

An invalid intent was sent.

DisallowedIntents

A disallowed intent was sent, may need allowlisting.

Implementations

impl CloseCode

pub const fn can_reconnect(self) -> bool

Whether the close code is one that allows reconnection of a shard.

Some close codes are considered fatal, meaning that using the same gateway shard configuration would error. For example, the AuthenticationFailed close code occurs when the provided Discord bot token is invalid, and so attempting to reconnect with the same token would fail. On the other hand, a close code such as RateLimited occurs when too many gateway commands are sent in a short time, and so creating a new connection would succeed.

Refer to Discord Docs/Gateway Close Event Codes for more information.

Reconnectable close codes

• UnknownError
• DecodeError
• NotAuthenticated
• AlreadyAuthenticated
• InvalidSequence
• RateLimited
• SessionTimedOut

Fatal close codes

• AuthenticationFailed
• InvalidShard
• ShardingRequired
• InvalidApiVersion
• InvalidIntents
• DisallowedIntents

Trait Implementations

impl Clone for CloseCode

fn clone(&self) -> CloseCode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CloseCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CloseCode

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for CloseCode

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

Formats the value using the given formatter.

impl Hash for CloseCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<CloseCode> for CloseCode

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CloseCode

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<u16> for CloseCode

type Error = CloseCodeConversionError

The type returned in the event of a conversion error.

fn try_from(value: u16) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for CloseCode

impl Eq for CloseCode

impl StructuralEq for CloseCode

impl StructuralPartialEq for CloseCode