Class that programmatically interacts with widgets and the test environment.

For convenience, instances of this class (such as the one provided by testWidget) can be used as the vsync for AnimationController objects.

Inheritance
Implements
  • HitTestDispatcher
  • TickerProvider

Properties

binding → TestWidgetsFlutterBinding

The binding instance used by the testing framework.

read-only
allElements → Iterable<Element>

All elements currently in the widget tree (lazy pre-order traversal).

read-only, inherited
allRenderObjects → Iterable<RenderObject>

Render objects of all the widgets currently in the widget tree (lazy pre-order traversal).

read-only, inherited
allStates → Iterable<State>

All states currently in the widget tree (lazy pre-order traversal).

read-only, inherited
allWidgets → Iterable<Widget>

All widgets currently in the widget tree (lazy pre-order traversal).

read-only, inherited
hashCode → int

Get a hash code for this object.

read-only, inherited
layers → List<Layer>

Returns a list of all the Layer objects in the rendering.

read-only, inherited
runtimeType → Type

A representation of the runtime type of the object.

read-only, inherited

Operators

operator ==(other) → bool

The equality operator.

inherited

Methods

createTicker(TickerCallback onTick) → Ticker

Creates a ticker with the given callback.

dispatchEvent(PointerEvent event, HitTestResult result) → void

Handler for device events caught by the binding in live test mode.

hitTestOnBinding(Point location) → HitTestResult

Forwards the given location to the binding's hitTest logic.

idle() → Future<Null>

Acts as if the application went idle.

pump([Duration duration, EnginePhase phase = EnginePhase.sendSemanticsTree ]) → Future<Null>

Triggers a frame after duration amount of time.

pumpUntilNoTransientCallbacks([Duration duration, EnginePhase phase = EnginePhase.sendSemanticsTree ]) → Future<int>

Repeatedly calls pump with the given duration until there are no longer any transient callbacks scheduled. If no transient callbacks are scheduled when the function is called, it returns without calling pump.

pumpWidget(Widget widget, [ Duration duration, EnginePhase phase = EnginePhase.sendSemanticsTree ]) → Future<Null>

Renders the UI from the given widget.

sendEventToBinding(PointerEvent event, HitTestResult result) → Future<Null>

Forwards the given pointer event to the binding.

takeException() → dynamic

Returns the exception most recently caught by the Flutter framework.

verifyTickersWereDisposed([String when = 'when none should have been' ]) → void

Throws an exception if any tickers created by the WidgetTester are still active when the method is called.

any(Finder finder) → bool

Checks if finder exists in the tree.

inherited
element(Finder finder) → Element

The matching element in the widget tree.

inherited
elementList(Finder finder) → Iterable<Element>

The matching elements in the widget tree.

inherited
firstElement(Finder finder) → Element

The first matching element according to a depth-first pre-order traversal of the widget tree.

inherited
firstRenderObject(Finder finder) → RenderObject

The render object of the first matching widget according to a depth-first pre-order traversal of the widget tree.

inherited
firstState(Finder finder) → State

The first matching state according to a depth-first pre-order traversal of the widget tree.

inherited
firstWidget(Finder finder) → Widget

The first matching widget according to a depth-first pre-order traversal of the widget tree.

inherited
fling(Finder finder, Offset offset, double velocity, { int pointer: 1, Duration frameInterval: const Duration(milliseconds: 16) }) → Future<Null>

Attempts a fling gesture starting from the center of the given widget, moving the given distance, reaching the given velocity.

inherited
flingFrom(Point startLocation, Offset offset, double velocity, { int pointer: 1, Duration frameInterval: const Duration(milliseconds: 16) }) → Future<Null>

Attempts a fling gesture starting from the given location, moving the given distance, reaching the given velocity.

inherited
getBottomLeft(Finder finder) → Point

Returns the point at the bottom left of the given widget. This point is not inside the object's hit test area.

inherited
getBottomRight(Finder finder) → Point

Returns the point at the bottom right of the given widget. This point is not inside the object's hit test area.

inherited
getCenter(Finder finder) → Point

Returns the point at the center of the given widget.

inherited
getSize(Finder finder) → Size

Returns the size of the given widget. This is only valid once the widget's render object has been laid out at least once.

inherited
getTopLeft(Finder finder) → Point

Returns the point at the top left of the given widget.

inherited
getTopRight(Finder finder) → Point

Returns the point at the top right of the given widget. This point is not inside the object's hit test area.

inherited
noSuchMethod(Invocation invocation) → dynamic

Invoked when a non-existent method or property is accessed.

inherited
renderObject(Finder finder) → RenderObject

The render object of the matching widget in the widget tree.

inherited
renderObjectList(Finder finder) → Iterable<RenderObject>

The render objects of the matching widgets in the widget tree.

inherited
scroll(Finder finder, Offset offset, { int pointer: 1 }) → Future<Null>

Attempts to drag the given widget by the given offset, by starting a drag in the middle of the widget.

inherited
scrollAt(Point startLocation, Offset offset, { int pointer: 1 }) → Future<Null>

Attempts a drag gesture consisting of a pointer down, a move by the given offset, and a pointer up.

inherited
startGesture(Point downLocation, { int pointer: 1 }) → Future<TestGesture>

Begins a gesture at a particular point, and returns the TestGesture object which you can use to continue the gesture.

inherited
state(Finder finder) → State

The matching state in the widget tree.

inherited
stateList(Finder finder) → Iterable<State>

The matching states in the widget tree.

inherited
tap(Finder finder, { int pointer: 1 }) → Future<Null>

Dispatch a pointer down / pointer up sequence at the center of the given widget, assuming it is exposed. If the center of the widget is not exposed, this might send events to another object.

inherited
tapAt(Point location, { int pointer: 1 }) → Future<Null>

Dispatch a pointer down / pointer up sequence at the given location.

inherited
toString() → String

Returns a string representation of this object.

inherited
widget(Finder finder) → Widget

The matching widget in the widget tree.

inherited
widgetList(Finder finder) → Iterable<Widget>

The matching widgets in the widget tree.

inherited