ConnectionQuality enum
Represents the perceived quality of the network connection based on latency, jitter, and stability.
The engine maps raw metrics (like RTT in milliseconds) to these categories using
the thresholds defined in `QualityThresholds`.
Values
- excellent → const ConnectionQuality
-
Excellent connection with very low latency and high stability.
Typically < 50ms. User Experience: Instantaneous page loads, seamless 4K streaming, and zero-lag competitive gaming.
- great → const ConnectionQuality
-
Great connection with low latency.
Typically < 100ms. User Experience: Fast browsing, high-quality video calls (VoIP/Zoom) without noticeable delay.
- good → const ConnectionQuality
-
Good, usable connection with acceptable latency.
Typically < 150ms. User Experience: Reliable for most tasks, though large file uploads or fast-paced games might show slight degradation.
- moderate → const ConnectionQuality
-
Moderate connection with noticeable latency.
Typically < 250ms. User Experience: Noticeable delays when opening new pages. Video streaming might occasionally buffer at the start.
- poor → const ConnectionQuality
-
Poor connection with high latency.
Typically < 500ms. User Experience: Frustratingly slow. Interactive applications feel "heavy" and unresponsive.
- unstable → const ConnectionQuality
-
Connection is active, but high jitter or packet loss makes it unreliable.
This state occurs when latency is technically okay, but the "consistency" is missing (e.g., standard deviation of samples is too high). User Experience: "Stuttering" in calls, frequent disconnects, and unpredictable performance.
- captivePortal → const ConnectionQuality
-
A captive portal (login page) was detected.
The device is connected to a WiFi access point, but internet access is intercepted by a gateway (common in hotels/airports). User Experience: No internet access until the user signs in or accepts terms.
- offline → const ConnectionQuality
-
No connection detected or all essential targets failed.
User Experience: The app should enter its "Offline Mode".
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- index → int
-
A numeric identifier for the enumerated value.
no setterinherited
- 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
Constants
-
values
→ const List<
ConnectionQuality> - A constant List of the values in this enum, in order of their declaration.