text method
Finds Text, EditableText, and optionally RichText widgets
containing string equal to the text
argument.
If findRichText
is false, all standalone RichText widgets are
ignored and text
is matched with Text.data or Text.textSpan.
If findRichText
is true, RichText widgets (and therefore also
Text and Text.rich widgets) are matched by comparing the
InlineSpan.toPlainText with the given text
.
For EditableText widgets, the text
is always compared to the current
value of the EditableText.controller.
If the skipOffstage
argument is true (the default), then this skips
nodes that are Offstage or that are from inactive Routes.
Sample code
expect(find.text('Back'), findsOneWidget);
This will match Text, Text.rich, and EditableText widgets that contain the "Back" string.
expect(find.text('Close', findRichText: true), findsOneWidget);
This will match Text, Text.rich, EditableText, as well as standalone RichText widgets that contain the "Close" string.
Implementation
Finder text(
String text, {
bool findRichText = false,
bool skipOffstage = true,
}) {
return _TextWidgetFinder(
text,
findRichText: findRichText,
skipOffstage: skipOffstage,
);
}