FlutterDriver class Null safety
Drives a Flutter Application running in another process.
- Implementers
Constructors
- FlutterDriver()
- Default constructor.
- FlutterDriver.connectedTo({FlutterWebConnection? webConnection, VmService? serviceClient, Isolate? appIsolate})
-
Creates a driver that uses a connection provided by either the combination
of
webConnection
, or the combination ofserviceClient
andappIsolate
for the VM.factory
Properties
- appIsolate → Isolate
-
Getter of appIsolate.
read-only
- 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
- serviceClient → VmService
-
Getter of serviceClient.
read-only
- webDriver → WebDriver
-
Getter of webDriver.
read-only
Methods
-
checkHealth(
{Duration? timeout}) → Future< Health> - Checks the status of the Flutter Driver extension.
-
clearTimeline(
{Duration timeout = kUnusuallyLongTimeout}) → Future< void> - Clears all timeline events recorded up until now. [...]
-
close(
) → Future< void> - Closes the underlying connection to the VM service. [...]
-
enableAccessibility(
) → Future< void> -
Enables accessibility feature.
@Deprecated('Call setSemantics(true) instead. ' 'This feature was deprecated after v2.3.0-12.1.pre.')
-
enterText(
String text, {Duration? timeout}) → Future< void> -
Enters
text
into the currently focused text input, such as the EditableText widget. [...] -
forceGC(
) → Future< void> - Force a garbage collection run in the VM. [...]
-
getBottomLeft(
SerializableFinder finder, {Duration? timeout}) → Future< DriverOffset> -
Returns the point at the bottom left of the widget identified by
finder
. [...] -
getBottomRight(
SerializableFinder finder, {Duration? timeout}) → Future< DriverOffset> -
Returns the point at the bottom right of the widget identified by
finder
. [...] -
getCenter(
SerializableFinder finder, {Duration? timeout}) → Future< DriverOffset> -
Returns the point at the center of the widget identified by
finder
. [...] -
getLayerTree(
{Duration? timeout}) → Future< LayerTree> - Returns a dump of the layer tree.
-
getRenderObjectDiagnostics(
SerializableFinder finder, {int subtreeDepth = 0, bool includeProperties = true, Duration? timeout}) → Future< Map< String, Object?> > -
Returns a JSON map of the DiagnosticsNode that is associated with the
RenderObject identified by
finder
. [...] -
getRenderTree(
{Duration? timeout}) → Future< RenderTree> - Returns a dump of the render tree.
-
getSemanticsId(
SerializableFinder finder, {Duration? timeout}) → Future< int> -
Retrieves the semantics node id for the object returned by
finder
, or the nearest ancestor with a semantics node. [...] -
getText(
SerializableFinder finder, {Duration? timeout}) → Future< String> -
Returns the text in the
Text
widget located byfinder
. -
getTopLeft(
SerializableFinder finder, {Duration? timeout}) → Future< DriverOffset> -
Returns the point at the top left of the widget identified by
finder
. [...] -
getTopRight(
SerializableFinder finder, {Duration? timeout}) → Future< DriverOffset> -
Returns the point at the top right of the widget identified by
finder
. [...] -
getVmFlags(
) → Future< List< Map< >String, dynamic> > - Returns the Flags set in the Dart VM as JSON. [...]
-
getWidgetDiagnostics(
SerializableFinder finder, {int subtreeDepth = 0, bool includeProperties = true, Duration? timeout}) → Future< Map< String, Object?> > -
Returns a JSON map of the DiagnosticsNode that is associated with the
Widget identified by
finder
. [...] -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed. [...]
inherited
-
requestData(
String? message, {Duration? timeout}) → Future< String> - Sends a string and returns a string. [...]
-
runUnsynchronized<
T> (Future< T> action(), {Duration? timeout}) → Future<T> -
action
will be executed with the frame sync mechanism disabled. [...] -
screenshot(
) → Future< List< int> > - Take a screenshot. [...]
-
scroll(
SerializableFinder finder, double dx, double dy, Duration duration, {int frequency = 60, Duration? timeout}) → Future< void> - Tell the driver to perform a scrolling action. [...]
-
scrollIntoView(
SerializableFinder finder, {double alignment = 0.0, Duration? timeout}) → Future< void> -
Scrolls the Scrollable ancestor of the widget located by
finder
until the widget is completely visible. [...] -
scrollUntilVisible(
SerializableFinder scrollable, SerializableFinder item, {double alignment = 0.0, double dxScroll = 0.0, double dyScroll = 0.0, Duration? timeout}) → Future< void> -
Repeatedly scroll the widget located by
scrollable
bydxScroll
anddyScroll
untilitem
is visible, and then use scrollIntoView to ensure the item's final position matchesalignment
. [...] -
sendCommand(
Command command) → Future< Map< String, dynamic> > -
Sends
command
to the Flutter Driver extensions. This must be implemented by subclass. [...] -
setSemantics(
bool enabled, {Duration? timeout}) → Future< bool> - Turns semantics on or off in the Flutter app under test. [...]
-
setTextEntryEmulation(
{required bool enabled, Duration? timeout}) → Future< void> - Configures text entry emulation. [...]
-
startTracing(
{List< TimelineStream> streams = const <TimelineStream>[TimelineStream.all], Duration timeout = kUnusuallyLongTimeout}) → Future<void> - Starts recording performance traces. [...]
-
stopTracingAndDownloadTimeline(
{Duration timeout = kUnusuallyLongTimeout}) → Future< Timeline> - Stops recording performance traces and downloads the timeline. [...]
-
tap(
SerializableFinder finder, {Duration? timeout}) → Future< void> -
Taps at the center of the widget located by
finder
. -
toString(
) → String -
A string representation of this object. [...]
inherited
-
traceAction(
Future action(), {List< TimelineStream> streams = const <TimelineStream>[TimelineStream.all], bool retainPriorEvents = false}) → Future<Timeline> -
Runs
action
and outputs a performance trace for it. [...] -
waitFor(
SerializableFinder finder, {Duration? timeout}) → Future< void> -
Waits until
finder
locates the target. [...] -
waitForAbsent(
SerializableFinder finder, {Duration? timeout}) → Future< void> -
Waits until
finder
can no longer locate the target. -
waitForCondition(
SerializableWaitCondition waitCondition, {Duration? timeout}) → Future< void> -
Waits until the given
waitCondition
is satisfied. -
waitForTappable(
SerializableFinder finder, {Duration? timeout}) → Future< void> -
Waits until
finder
is tappable. -
waitUntilFirstFrameRasterized(
) → Future< void> - Waits until the next dart:ui.PlatformDispatcher.onReportTimings is called. [...]
-
waitUntilNoTransientCallbacks(
{Duration? timeout}) → Future< void> - Waits until there are no more transient callbacks in the queue. [...]
Operators
-
operator ==(
Object other) → bool -
The equality operator. [...]
inherited