FlightEvent class

A single, immutable entry in the flight recorder's rolling timeline.

Instances are normally created by FlightRecorder, which is responsible for assigning id, applying privacy sanitization to metadata, and enforcing the rolling buffer capacity. Constructing a FlightEvent directly bypasses that sanitization, so application code should prefer FlightRecorder.recordAction / .log / .recordError instead.

Annotations

• @immutable

Constructors

FlightEvent({required String id, required DateTime timestamp, required EventCategory category, required String name, Map<String, Object?> metadata = const {}, EventSeverity? severity})

Creates a single timeline entry.

Properties

category → EventCategory

Which kind of activity this event represents.

final

hashCode → int

The hash code for this object.

no setter, inherited

id → String

Unique within a recording session. Not a global UUID.

final

metadata → Map<String, Object?>

Already sanitized and JSON-safe by the time an event reaches the buffer. Unmodifiable.

final

name → String

Short human-meaningful label, e.g. 'save_profile_tapped' or a route name. Not free-form prose.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

severity → EventSeverity?

Set for log and error category events; null for the others, which have no notion of severity.

final

timestamp → DateTime

When this event was recorded.

final

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toJson() → Map<String, Object?>

JSON-safe representation of this event, e.g. for embedding in an incident's timeline array.

toString() → String

A string representation of this object.

override

Operators

operator ==(Object other) → bool

The equality operator.

inherited