Enum DeviceType

pub enum DeviceType {
    Desktop,
    Mobile,
    Tablet,
    VR,
    TV,
    Unknown,
}

Enumeration for the different types of device.

Firefox Accounts and the broader Sync universe separates devices into broad categories for various purposes, such as distinguishing a desktop PC from a mobile phone.

A special variant in this enum, DeviceType::Unknown is used to capture the string values we don’t recognise. It also has a custom serde serializer and deserializer which implements the following semantics:

• deserializing a DeviceType which uses a string value we don’t recognise or null will return DeviceType::Unknown rather than returning an error.
• serializing DeviceType::Unknown will serialize null.

This has a few important implications:

• In general, Option<DeviceType> should be avoided, and a plain DeviceType used instead, because in that case, None would be semantically identical to DeviceType::Unknown and as mentioned above, null already deserializes as DeviceType::Unknown.
• Any unknown device types can not be round-tripped via this enum - eg, if you deserialize a struct holding a DeviceType string value we don’t recognize, then re-serialize it, the original string value is lost. We don’t consider this a problem because in practice, we only upload records with this device’s type, not the type of other devices, and it’s reasonable to assume that this module knows about all valid device types for the device type it is deployed on.

Variants

Desktop

Mobile

Tablet

VR

TV

Unknown

Trait Implementations

impl Clone for DeviceType

fn clone(&self) -> DeviceType

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceType

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

Formats the value using the given formatter.

impl Default for DeviceType

fn default() -> DeviceType

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DeviceType

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for DeviceType

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

where __H: Hasher,

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 for DeviceType

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for DeviceType

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for DeviceType

impl Eq for DeviceType

impl StructuralPartialEq for DeviceType