LiveTestWidgetsFlutterBindingFramePolicy enum

Available policies for how a LiveTestWidgetsFlutterBinding should paint frames.

These values are set on the binding's LiveTestWidgetsFlutterBinding.framePolicy property. The default is fadePointers.


benchmark → const LiveTestWidgetsFlutterBindingFramePolicy

Ignore any request to schedule a frame.

This is intended to be used by benchmarks (hence the name) that drive the pipeline directly. It tells the binding to entirely ignore requests for a frame to be scheduled, while still allowing frames that are pumped directly to run (either by using WidgetTester.pumpBenchmark or invoking Window.onBeginFrame and Window.onDrawFrame).

The SchedulerBinding.hasScheduledFrame property will never be true in this mode. This can cause unexpected effects. For instance, WidgetTester.pumpAndSettle does not function in this mode, as it relies on the SchedulerBinding.hasScheduledFrame property to determine when the application has "settled".

const LiveTestWidgetsFlutterBindingFramePolicy(3)
fadePointers → const LiveTestWidgetsFlutterBindingFramePolicy

Show pumped frames, and additionally schedule and run frames to fade out the pointer crosshairs and other debugging information shown by the binding.

This can result in additional frames being pumped beyond those that the test itself requests, which can cause differences in behavior.

const LiveTestWidgetsFlutterBindingFramePolicy(1)
fullyLive → const LiveTestWidgetsFlutterBindingFramePolicy

Show every frame that the framework requests, even if the frames are not explicitly pumped.

This can help with orienting the developer when looking at heavily-animated situations, and will almost certainly result in additional frames being pumped beyond those that the test itself requests, which can cause differences in behavior.

const LiveTestWidgetsFlutterBindingFramePolicy(2)
onlyPumps → const LiveTestWidgetsFlutterBindingFramePolicy

Strictly show only frames that are explicitly pumped. This most closely matches the behavior of tests when run under flutter test.

const LiveTestWidgetsFlutterBindingFramePolicy(0)
values → const List<LiveTestWidgetsFlutterBindingFramePolicy>

A constant List of the values in this enum, in order of their declaration.

const List<LiveTestWidgetsFlutterBindingFramePolicy>


index int

The integer index of this enum.

hashCode int
The hash code for this object. [...]
read-only, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited


toString() String
Returns a string representation of this object.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]


operator ==(dynamic other) bool
The equality operator. [...]