flutter_test library

抖动测试库,基于package:test之上.

Test Configuration

测试库提供了一些构造,项目可以通过这些构造来配置其测试.

Per test or per file

由于使用package:test作为基础,因此测试库允许使用package:test存在的现有构造来初始化package:test . 这些包括setUpsetUpAll方法.

Per directory hierarchy

除了package:test提供的构造之外,该库还支持目录级别的测试配置.

在执行测试文件之前,Flutter测试框架将扫描目录层次结构,从测试文件所在的目录开始,查找名为flutter_test_config.dart的文件. 如果找到这样的配置文件,则将假定该文件具有带有以下签名的main方法:

Future<void> main(FutureOr<void> testMain());

测试框架将执行该方法,并将其传递给测试的main()方法. 然后,配置文件的main()方法负责调用测试的main()方法.

测试框架找到配置文件后,它将停止扫描目录层次结构. 换句话说,将选择最靠近测试文件的测试配置文件,而所有其他测试配置文件将被忽略. 同样,当找到pubspec.yaml时,它将停止扫描目录层次结构,因为这表明项目的根目录.

如果未找到配置文件,则将像往常一样执行测试.

Classes

AccessibilityGuideline
可访问性指南描述了应用程序应被视为可访问的建议.
AutomatedTestWidgetsFlutterBinding
TestWidgetsFlutterBinding的变体,用于在flutter test环境中执行测试. [...]
ChainedFinder
Finder应用其他过滤.
CommonFinders
提供轻量级语法,以获取常用的小部件Finder . [...]
ComparisonResult
像素比较测试的结果. [...]
CustomMatcher
A useful utility class for implementing other matchers through inheritance. Derived classes should call the base constructor with a feature name and description, and an instance matcher, and should implement the featureValueOf abstract method. [...]
CustomMinimumContrastGuideline
验证取景器指定的所有元素均符合最低对比度的准则.
DefaultTestVariant
TestVariant表示,如果没有正在运行的"默认"测试variants迭代被指定testWidgets . [...]
DefaultWebGoldenComparator
存在用于API兼容性的不受支持的WebGoldenComparator .
Description
匹配器通过附加到Description对象来建立其错误消息. [...]
Evaluation
通过AccessibilityGuideline评估语义节点的结果.
Finder
搜索窗口小部件树并返回与特定模式匹配的节点.
Future<T>
表示延迟计算的对象. [...]
GoldenFileComparator
将图像像素与金色图像文件进行比较. [...]
KeyEventSimulator
用作一堆键盘键生成实用程序的名称空间的类.
LabeledTapTargetGuideline
一条准则,要求所有具有轻击或长按动作的节点也应带有标签.
LiveTestWidgetsFlutterBinding
TestWidgetsFlutterBinding的一种变体,用于在设备上的flutter run环境中执行测试. 目的是允许进行交互式测试开发. [...]
LiveWidgetController
可以在设备上运行的测试中使用的WidgetController的变体. [...]
LocalComparisonOutput
在本地运行并提供输出的黄金文件比较器中使用的类.
LocalFileComparator
flutter test的默认GoldenFileComparator实现. [...]
Matcher
所有匹配器的基类. [...]
MatchFinder
搜索窗口小部件树并返回与特定模式匹配的节点.
MinimumTapTargetGuideline
强制所有可点击的语义节点都具有最小大小的准则. [...]
MinimumTextContrastGuideline
验证所有通过文本提供语义的节点是否符合最低对比级别的准则. [...]
Offset
不变的2D浮点偏移量. [...]
OnPlatform
用于测试套件的特定于平台的自定义的注释. [...]
Retry
用于标记要重试的注释. [...]
SemanticsHandle
对语义树的引用. [...]
Skip
用于将测试套件标记为已跳过的注释.
StreamMatcher
一个匹配器,匹配来自StreamStreamQueue的事件. [...]
StringDescription
Description的默认实现. 尽管可以想象这是可以支持其他语言的地方,但这几乎不需要替换.
Tags
用于将一组用户定义的标签应用于测试套件的注释. [...]
TargetPlatformVariant
一个TestVariant ,它运行将debugDefaultTargetPlatformOverride设置为TargetPlatform的不同值的测试.
TestAsyncUtils
flutter_test库中所有异步API的实用程序类. [...]
TestDefaultBinaryMessenger
A BinaryMessenger subclass that is used as the default binary messenger under testing environment. [...]
TestFailure
测试断言失败时引发的异常.
TestGesture
在测试中执行手势的类. [...]
TestOn
指示测试套件支持哪些平台的注释. [...]
TestPointer
用于生成相干人工指针事件的类. [...]
TestTextInput
系统屏幕键盘的测试存根. [...]
TestVariant<T>
用于描述测试环境变体的抽象基类. [...]
TestViewConfiguration
假装显示的ViewConfiguration具有特定的大小. 大小以逻辑像素为单位. 生成的ViewConfiguration使用BoxFit.contain算法将给定的大小映射到实际显示中.
TestVSync
创建独立股票行情的TickerProvider . [...]
TestWidgetsFlutterBinding
窗口小部件库测试使用的绑定的基类. [...]
TestWindow
窗口是包装另一个窗口 ,并允许一些属性用于测试目的的伪装. [...]
TextEditingValue
当前文本,选择和编辑文本的状态.
Throws
请改用throwsA函数.
Timeout
表示对测试默认超时的修改的类. [...]
TrivialComparator
当尚未在测试引导程序中进行的初始化尚未发生或已被绕过时,将占位符比较器设置为goldenFileComparator的值. [...]
WebGoldenComparator
将图像像素与金色图像文件进行比较. [...]
WidgetController
与小部件以编程方式进行交互的类. [...]
WidgetTester
以编程方式与小部件和测试环境进行交互的类. [...]

Constants

androidTapTargetGuideline → const AccessibilityGuideline
一条指南,要求可点击的语义节点的最小大小为48 x48. [...]
const MinimumTapTargetGuideline._(const Size(48.0, 48.0), 'https://support.google.com/accessibility/android/answer/7101858?hl=en')
anything → const Matcher
匹配任何值的匹配器.
const _IsAnything()
clipsWithBoundingRect → const Matcher
断言Finder查找单个对象,该对象的根RenderObject是未设置裁剪器的RenderClipRect或等效的RenderClipPath .
_ClipsWithBoundingRect()
find → const CommonFinders
一些常用的小部件Finder .
CommonFinders._()
findsNothing → const Matcher
断言Finder不匹配窗口小部件树中的窗口小部件. [...]
_FindsWidgetMatcher(null, 0)
findsOneWidget → const Matcher
断言Finder恰好位于窗口小部件树中的一个窗口小部件上. [...]
_FindsWidgetMatcher(1, 1)
findsWidgets → const Matcher
断言Finder在小部件树中找到了至少一个小部件. [...]
_FindsWidgetMatcher(1, null)
hasAGoodToStringDeep → const Matcher
断言对象的toStringDeep()是合理的多行描述. [...]
_HasGoodToStringDeep()
hasNoImmediateClip → const Matcher
断言Finder找到一个根RenderObject不是RenderClipRectRenderClipRRectRenderClipOvalRenderClipPath的对象 .
_MatchAnythingExceptClip()
hasOneLineDescription → const Matcher
断言对象的toString()是合理的单行描述. [...]
_HasOneLineDescription()
iOSTapTargetGuideline → const AccessibilityGuideline
一条指南,要求可点击的语义节点的最小大小为44 x44. [...]
const MinimumTapTargetGuideline._(const Size(44.0, 44.0), 'https://developer.apple.com/design/human-interface-guidelines/ios/visual-design/adaptivity-and-layout/?…
isArgumentError → const TypeMatcher<ArgumentError>
ArgumentError的匹配器.
const TypeMatcher<ArgumentError>()
isCastError → const TypeMatcher<CastError>
CastError的匹配器.
const TypeMatcher<CastError>()
isConcurrentModificationError → const TypeMatcher<ConcurrentModificationError>
ConcurrentModificationError的匹配器.
const TypeMatcher<ConcurrentModificationError>()
isCyclicInitializationError → const TypeMatcher<CyclicInitializationError>
CyclicInitializationError的匹配器.
const TypeMatcher<CyclicInitializationError>()
isEmpty → const Matcher
返回与isEmpty属性匹配的匹配器.
const _Empty()
isException → const TypeMatcher<Exception>
Exception的匹配器.
const TypeMatcher<Exception>()
isFalse → const Matcher
一个匹配器,匹配除布尔值true外的任何内容.
const _IsFalse()
isFormatException → const TypeMatcher<FormatException>
FormatException的匹配器.
const TypeMatcher<FormatException>()
isInCard → const Matcher
断言Finder找到一个具有至少一个Card小部件祖先的小部件. [...]
_IsInCard()
isList → const TypeMatcher<List>
List的匹配器.
const TypeMatcher<List>()
isMap → const TypeMatcher<Map>
Map的匹配器.
const TypeMatcher<Map>()
isNaN → const Matcher
一个匹配数值NaN的匹配器.
const _IsNaN()
isNegative → const Matcher
如果match参数为负,则匹配的匹配器.
const _OrderingMatcher(0, false, true, false, 'a negative value', false)
isNonNegative → const Matcher
如果match参数为零或正数,则匹配的匹配器.
const _OrderingMatcher(0, true, false, true, 'a non-negative value', false)
isNonPositive → const Matcher
如果match参数为零或负,则匹配的匹配器.
const _OrderingMatcher(0, true, true, false, 'a non-positive value', false)
isNonZero → const Matcher
如果match参数为非零,则匹配的匹配器.
const _OrderingMatcher(0, false, true, true, 'a value not equal to')
isNoSuchMethodError → const TypeMatcher<NoSuchMethodError>
NoSuchMethodError的匹配器.
const TypeMatcher<NoSuchMethodError>()
isNotEmpty → const Matcher
返回与isNotEmpty属性匹配的匹配器.
const _NotEmpty()
isNotInCard → const Matcher
断言Finder找到了一个没有Card窗口小部件祖先的窗口小部件. [...]
_IsNotInCard()
isNotNaN → const Matcher
与任何非NaN值匹配的匹配器.
const _IsNotNaN()
isNotNull → const Matcher
与任何非空值匹配的匹配器.
const _IsNotNull()
isNull → const Matcher
与任何空值匹配的匹配器.
const _IsNull()
isNullThrownError → const TypeMatcher<NullThrownError>
NullThrownError的匹配器.
const TypeMatcher<NullThrownError>()
isOffstage → const Matcher
Asserts that the Finder locates a single widget that has at least one Offstage widget ancestor. [...]
_IsOffstage()
isOnstage → const Matcher
断言Finder找到一个没有Offstage小部件祖先的单个小部件. [...]
_IsOnstage()
isPositive → const Matcher
如果match参数为正,则匹配的匹配器.
const _OrderingMatcher(0, false, false, true, 'a positive value', false)
isRangeError → const TypeMatcher<RangeError>
RangeError的匹配器.
const TypeMatcher<RangeError>()
isStateError → const TypeMatcher<StateError>
StateError的匹配器.
const TypeMatcher<StateError>()
isTrue → const Matcher
与布尔值true相匹配的匹配器.
const _IsTrue()
isUnimplementedError → const TypeMatcher<UnimplementedError>
A matcher for UnimplementedError.
const TypeMatcher<UnimplementedError>()
isUnsupportedError → const TypeMatcher<UnsupportedError>
UnsupportedError的匹配器.
const TypeMatcher<UnsupportedError>()
isZero → const Matcher
如果match参数为零,则匹配的匹配器.
const _OrderingMatcher(0, true, false, false, 'a value equal to')
kDragSlopDefault → const double
默认的拖动触摸倾斜度用于将较大的阻力分解为多个较小的动作. [...]
20.0
labeledTapTargetGuideline → const AccessibilityGuideline
一条准则,要求所有具有轻击或长按动作的节点也应带有标签.
const LabeledTapTargetGuideline._()
returnsNormally → const Matcher
一个匹配函数的匹配器,无一例外. [...]
const _ReturnsNormally()
textContrastGuideline → const AccessibilityGuideline
要求文本对比度达到最小值的准则. [...]
const MinimumTextContrastGuideline._()
throws → const Matcher
不推荐使用此功能. [...]
@ 不推荐使用 ("将在0.13.0中删除")
const Throws ()
throwsArgumentError → const Matcher
引发ArgumentError的函数的匹配器.
const Throws (isArgumentError)
throwsConcurrentModificationError → const Matcher
引发ConcurrentModificationError的函数的匹配器.
const Throws (isConcurrentModificationError)
throwsCyclicInitializationError → const Matcher
引发CyclicInitializationError的函数的匹配器.
const Throws (isCyclicInitializationError)
throwsException → const Matcher
引发Exception的函数的匹配器.
const Throws (isException)
throwsFormatException → const Matcher
引发FormatException的函数的匹配器.
const Throws (isFormatException)
throwsNoSuchMethodError → const Matcher
引发NoSuchMethodError的函数的匹配器.
const Throws (isNoSuchMethodError)
throwsNullThrownError → const Matcher
引发NullThrownError的函数的匹配器.
const Throws (isNullThrownError)
throwsRangeError → const Matcher
引发RangeError的函数的匹配器.
const Throws (isRangeError)
throwsStateError → const Matcher
引发StateError的函数的匹配器.
const Throws (isStateError)
throwsUnimplementedError → const Matcher
引发Exception的函数的匹配器.
const Throws (isUnimplementedError)
throwsUnsupportedError → const Matcher
引发UnsupportedError的函数的匹配器.
const Throws (isUnsupportedError)

Properties

autoUpdateGoldenFiles bool
测试期间是否应自动更新黄金文件,而不是与测试记录的图像字节进行比较. [...]
读/写
completes Matcher
匹配一个成功完成并带有值的未来 . [...]
最后
doesNotComplete Matcher
匹配未完成的未来 . [...]
最后
emitsDone StreamMatcher
返回一个StreamMatcher ,断言该流发出"完成"事件.
最后
goldenFileComparator GoldenFileComparator
将像素与黄金图像文件的像素进行比较. [...]
读/写
isAssertionError TypeMatcher<AssertionError>
AssertionError的匹配器. [...]
最后
isBrowser bool
Whether the test is running in a web browser compiled to JavaScript.
read-only
isFlutterError TypeMatcher<FlutterError>
FlutterError匹配. [...]
最后
isLinux bool
测试是否在Linux操作系统上运行. [...]
只读
isMacOS bool
测试是否在macOS操作系统上运行. [...]
只读
isWindows bool
测试是否正在Windows操作系统上运行. [...]
只读
neverCalled Null Function([Object, Object, Object, Object, Object, Object, Object, Object, Object, Object])
返回一个函数,如果调用该函数,它将导致测试失败. [...]
只读
reportTestException TestExceptionReporter
测试过程中发生意外错误时,测试框架将调用该函数. [...]
读/写
throwsAssertionError Matcher
引发AssertionError的函数的匹配器. [...]
最后
throwsFlutterError Matcher
引发FlutterError的函数的匹配器. [...]
最后
webGoldenComparator WebGoldenComparator
将像素与黄金图像文件的像素进行比较. [...]
读/写

Functions

addStateInfo(Map matchState, Map values) → void
嵌套匹配状态的有用工具.
addTearDown(dynamic callback()) → void
注册在当前测试后要运行的功能. [...]
allOf(dynamic arg0, [dynamic arg1, dynamic arg2, dynamic arg3, dynamic arg4, dynamic arg5, dynamic arg6]) Matcher
如果作为参数传递的所有匹配器(最多7个)匹配,则返回匹配的匹配器. [...]
anyElement(dynamic matcher) Matcher
返回与Iterable相匹配的匹配器,其中至少一个元素与给定的matcher .
anyOf(dynamic arg0, [dynamic arg1, dynamic arg2, dynamic arg3, dynamic arg4, dynamic arg5, dynamic arg6]) Matcher
如果任何给定的匹配器评估为true,则匹配. [...]
benchmarkWidgets(WidgetTesterCallback callback, {bool mayRunWithAsserts: false, bool semanticsEnabled: false}) Future<void>
在Flutter基准测试环境中运行callback . [...]
clipsWithBoundingRRect({BorderRadius borderRadius}) Matcher
断言Finder查找单个对象,该对象的根RenderObject是未设置裁剪器的RenderClipRRect ,并且边框半径等于borderRadius或等效的RenderClipPath .
clipsWithShapeBorder({ShapeBorder shape}) Matcher
断言Finder找到一个单个对象,该对象的根RenderObject是一个具有ShapeBorderClipperRenderClipPath ,该ShapeBorderClipper会剪切 shape .
closeTo(num value, num delta) Matcher
如果match参数在某个value delta范围内,则返回匹配的匹配器. [...]
collapseWhitespace(String string) String
折叠空格的实用程序功能可运行到单个空格并去除前导/尾随空格.
collectAllElementsFrom(Element rootElement, {bool skipOffstage}) Iterable<Element>
提供一个可迭代的对象,可以有效地返回以给定元素为根的所有元素. 有关详细信息,请参见CachingIterable . [...]
compareLists(List<int> test, List<int> master) ComparisonResult
返回一个CompareResult,以描述所提供的test图像和master图像字节的像素差异.
completion(dynamic matcher, [String description]) Matcher
通过匹配matcher的值匹配成功完成的Future . [...]
contains(dynamic expected) Matcher
Returns a matcher that matches if the match argument contains the expected value. [...]
containsAll(Iterable expected) Matcher
匹配Iterable ,其中包含一个元素,该元素以expected的任何顺序匹配每个值,并且可能包含其他值. [...]
containsAllInOrder(Iterable expected) Matcher
匹配Iterable ,其中包含一个元素,该元素按相同顺序按expected顺序匹配每个值,但可能包含贯穿其间的其他值. [...]
containsPair(dynamic key, dynamic value) Matcher
返回一个匹配器,该匹配器匹配包含key => value的键值对的映射.
containsValue(dynamic value) Matcher
返回一个匹配器,该匹配器匹配包含给定value地图.
coversSameAreaAs(Path expectedPath, {Rect areaToCompare, int sampleSize: 20}) Matcher
通过采样多个点来断言2条路径覆盖同一区域. [...]
doesNotMeetGuideline(AccessibilityGuideline guideline) → AsyncMatcher
MeetsGuideline的逆匹配器. [...]
emits(dynamic matcher) StreamMatcher
返回matcherStreamMatcher . [...]
emitsAnyOf(Iterable matchers) StreamMatcher
如果matchers中的至少一个匹配,则返回与流匹配的StreamMatcher . [...]
emitsError(dynamic matcher) StreamMatcher
返回与单个匹配matcher错误事件匹配的StreamMatcher .
emitsInAnyOrder(Iterable matchers) StreamMatcher
如果匹配器中的每个匹配matchers以任意顺序匹配,则返回与流匹配的StreamMatcher . [...]
emitsInOrder(Iterable matchers) StreamMatcher
如果匹配器中的每个匹配matchers相匹配,则返回一个与流匹配的StreamMatcher . [...]
emitsThrough(dynamic matcher) StreamMatcher
返回与任意数量的事件匹配的StreamMatcher ,后跟与matcher的事件. [...]
endsWith(String suffixString) Matcher
如果match参数是一个字符串并以suffixString结尾,则返回匹配的匹配器.
equals(dynamic expected, [int limit = 100]) Matcher
如果该值在结构上等于expected ,则返回匹配的匹配器. [...]
equalsIgnoringCase(String value) Matcher
返回一个匹配器,如果match参数是一个字符串,并且不区分大小写地进行比较,则该匹配器等于value .
equalsIgnoringHashCodes(String value) Matcher
在规范化可能的哈希码后,断言两个String相等. [...]
equalsIgnoringWhitespace(String value) Matcher
返回一个匹配器,如果match参数是一个字符串并且等于value ,则忽略空白,该匹配器将匹配. [...]
escape(String str) String
返回带有所有空格字符的str表示为它们的转义序列. [...]
everyElement(dynamic matcher) Matcher
返回与Iterable相匹配的匹配器,其中所有元素都与给定的matcher .
expect(dynamic actual, dynamic matcher, {String reason, dynamic skip}) → void
断言actual匹配matcher . [...]
expectAsync(Function callback, {int count: 1, int max: 0, String id, String reason}) Function
This function is deprecated because it doesn't work well with strong mode. Use expectAsync0, expectAsync1, expectAsync2, expectAsync3, expectAsync4, expectAsync5, or expectAsync6 instead.
@ 不推荐使用 ("将在0.13.0中删除")
expectAsync0<T>(T callback(), {int count: 1, int max: 0, String id, String reason}) Func0<T>
通知框架,预期给定值为0的给定callback将被称为count次数(默认为1). [...]
expectAsync1<T, A>(T callback(A), {int count: 1, int max: 0, String id, String reason}) Func1<T, A>
通知框架,预期给定类型为1的给定callback将被称为count次数(默认为1). [...]
expectAsync2<T, A, B>(T callback(A, B), {int count: 1, int max: 0, String id, String reason}) Func2<T, A, B>
通知框架,预期给定类型2的给定callback将被称为count次数(默认为1). [...]
expectAsync3<T, A, B, C>(T callback(A, B, C), {int count: 1, int max: 0, String id, String reason}) Func3<T, A, B, C>
通知框架,预期给定类型3的给定callback将被称为count次数(默认为1). [...]
expectAsync4<T, A, B, C, D>(T callback(A, B, C, D), {int count: 1, int max: 0, String id, String reason}) Func4<T, A, B, C, D>
通知框架,预期给定类型为4的给定callback将被称为count次数(默认为1). [...]
expectAsync5<T, A, B, C, D, E>(T callback(A, B, C, D, E), {int count: 1, int max: 0, String id, String reason}) Func5<T, A, B, C, D, E>
通知框架,预期给定类型为5的给定callback将被调用count次(默认为1次). [...]
expectAsync6<T, A, B, C, D, E, F>(T callback(A, B, C, D, E, F), {int count: 1, int max: 0, String id, String reason}) Func6<T, A, B, C, D, E, F>
通知框架,预期给定类型为6的给定callback将被称为count次数(默认为1). [...]
expectAsyncUntil(Function callback, bool isDone(), {String id, String reason}) Function
不建议使用此功能,因为它不能在强模式下正常运行. 请改用ExpectAsyncUntil0ExpectAsyncUntil1ExpectAsyncUntil2ExpectAsyncUntil3ExpectAsyncUntil4ExpectAsyncUntil5ExpectAsyncUntil6 .
@ 不推荐使用 ("将在0.13.0中删除")
expectAsyncUntil0<T>(T callback(), bool isDone(), {String id, String reason}) Func0<T>
通知框架,预期isarone 0的给定callback将被调用,直到isDone返回true. [...]
expectAsyncUntil1<T, A>(T callback(A), bool isDone(), {String id, String reason}) Func1<T, A>
通知框架,预期isarone 1的给定callback将被调用,直到isDone返回true. [...]
expectAsyncUntil2<T, A, B>(T callback(A, B), bool isDone(), {String id, String reason}) Func2<T, A, B>
通知框架,预期isarone 2的给定callback将被调用,直到isDone返回true. [...]
expectAsyncUntil3<T, A, B, C>(T callback(A, B, C), bool isDone(), {String id, String reason}) Func3<T, A, B, C>
通知框架,预期isarone 3的给定callback将被调用,直到isDone返回true. [...]
expectAsyncUntil4<T, A, B, C, D>(T callback(A, B, C, D), bool isDone(), {String id, String reason}) Func4<T, A, B, C, D>
通知框架,预期isarone 4的给定callback将被调用,直到isDone返回true. [...]
expectAsyncUntil5<T, A, B, C, D, E>(T callback(A, B, C, D, E), bool isDone(), {String id, String reason}) Func5<T, A, B, C, D, E>
通知框架,预期isarone 5的给定callback将被调用,直到isDone返回true. [...]
expectAsyncUntil6<T, A, B, C, D, E, F>(T callback(A, B, C, D, E, F), bool isDone(), {String id, String reason}) Func6<T, A, B, C, D, E, F>
通知框架,预期isarone 6的给定callback将被调用,直到isDone返回true. [...]
expectLater(dynamic actual, dynamic matcher, {String reason, dynamic skip}) Future<void>
就像期待 ,但返回的未来是完成时的匹配已经完成匹配. [...]
expectSync(dynamic actual, dynamic matcher, {String reason}) → void
断言actual匹配matcher . [...]
fail(String message) Null
使用提供的message抛出新的TestFailure的便捷方法.
@alwaysThrows
findsNWidgets(int n) Matcher
断言Finder在小部件树中找到了指定数量的小部件. [...]
greaterThan(dynamic value) Matcher
如果match参数大于给定value ,则返回匹配的匹配器.
greaterThanOrEqualTo(dynamic value) Matcher
如果match参数大于或等于给定value ,则返回匹配的匹配器.
group(Object description, void body(), {dynamic skip}) → void
创建一组测试. [...]
@isTestGroup
hasLength(dynamic matcher) Matcher
如果对象的length属性与matcher匹配,则返回匹配的matcher .
inClosedOpenRange(num low, num high) Matcher
如果match参数大于或等于low且小于high ,则返回匹配的匹配器.
inExclusiveRange(num low, num high) Matcher
如果match参数大于low并且小于high ,则返回匹配的匹配器.
inInclusiveRange(num low, num high) Matcher
如果match参数大于或等于low且小于或等于high ,则返回匹配的匹配器.
inOpenClosedRange(num low, num high) Matcher
如果match参数大于low且小于等于high ,则返回匹配的匹配器.
isA<T>() TypeMatcher<T>
返回匹配类型为T对象的匹配器. [...]
isIn(dynamic expected) Matcher
如果match参数在期望值内,则返回匹配的匹配器. 这是contains的反义词.
isInstanceOf<T>() TypeMatcher<T>
一个匹配器,将实际值的类型与类型参数T进行比较.
isMethodCall(String name, {dynamic arguments}) Matcher
MethodCall的匹配器,断言它具有指定的方法namearguments . [...]
isNot(dynamic matcher) Matcher
这将返回一个匹配器,将匹配matcher转换为其逻辑否定.
isSameColorAs(Color color) Matcher
断言该对象表示与用于绘画时的color相同的颜色. [...]
lessThan(dynamic value) Matcher
如果match参数小于给定value ,则返回匹配的匹配器.
lessThanOrEqualTo(dynamic value) Matcher
如果match参数小于或等于给定value ,则返回匹配的匹配器.
matches(dynamic re) Matcher
返回一个匹配器,如果match参数是字符串,则匹配该匹配器,并且匹配re给定的正则表达式. [...]
matchesGoldenFile(dynamic key, {int version}) → AsyncMatcher
断言FinderFuture <ui.Image>ui.Imagekey标识的黄金图像文件匹配,并带有可选的version号. [...]
matchesReferenceImage(Image image) → AsyncMatcher
断言FinderFuture <ui.Image>ui.Image匹配由image标识的参考image . [...]
matchesSemantics({String label, String hint, String value, String increasedValue, String decreasedValue, TextDirection textDirection, Rect rect, Size size, double elevation, double thickness, int platformViewId, int maxValueLength, int currentValueLength, bool hasCheckedState: false, bool isChecked: false, bool isSelected: false, bool isButton: false, bool isLink: false, bool isFocused: false, bool isFocusable: false, bool isTextField: false, bool isReadOnly: false, bool hasEnabledState: false, bool isEnabled: false, bool isInMutuallyExclusiveGroup: false, bool isHeader: false, bool isObscured: false, bool isMultiline: false, bool namesRoute: false, bool scopesRoute: false, bool isHidden: false, bool isImage: false, bool isLiveRegion: false, bool hasToggledState: false, bool isToggled: false, bool hasImplicitScrolling: false, bool hasTapAction: false, bool hasLongPressAction: false, bool hasScrollLeftAction: false, bool hasScrollRightAction: false, bool hasScrollUpAction: false, bool hasScrollDownAction: false, bool hasIncreaseAction: false, bool hasDecreaseAction: false, bool hasShowOnScreenAction: false, bool hasMoveCursorForwardByCharacterAction: false, bool hasMoveCursorBackwardByCharacterAction: false, bool hasMoveCursorForwardByWordAction: false, bool hasMoveCursorBackwardByWordAction: false, bool hasSetSelectionAction: false, bool hasCopyAction: false, bool hasCutAction: false, bool hasPasteAction: false, bool hasDidGainAccessibilityFocusAction: false, bool hasDidLoseAccessibilityFocusAction: false, bool hasDismissAction: false, String onTapHint, String onLongPressHint, List<CustomSemanticsAction> customActions, List<Matcher> children}) Matcher
断言SemanticsNode包含指定的信息. [...]
mayEmit(dynamic matcher) StreamMatcher
返回允许(但不要求) matcher匹配流的StreamMatcher . [...]
mayEmitMultiple(dynamic matcher) StreamMatcher
返回与匹配matcher任何数量的事件匹配的StreamMatcher . [...]
meetsGuideline(AccessibilityGuideline guideline) → AsyncMatcher
断言当前呈现的窗口小部件符合提供的辅助功能guideline . [...]
moreOrLessEquals(double value, {double epsilon: precisionErrorTolerance}) Matcher
断言两个double相等,处于一定容忍的误差之内. [...]
neverEmits(dynamic matcher) StreamMatcher
返回与从未匹配matcher的流匹配的StreamMatcher . [...]
nonconst<T>(T t) → T
可以使用此函数以创建新实例而不是创建公共const实例的方式调用const构造函数. [...]
offsetMoreOrLessEquals(Offset value, {double epsilon: precisionErrorTolerance}) Matcher
断言两个Offset相等,处于一定的容忍误差范围内. [...]
orderedEquals(Iterable expected) Matcher
返回一个匹配器,该匹配器以相同的顺序匹配长度与expected元素相同的Iterable . [...]
pairwiseCompare<S, T>(Iterable<S> expected, bool comparator(S a, T b), String description) Matcher
Iterable的成对匹配器. [...]
predicate<T>(bool f(T value), [String description = 'satisfies function']) Matcher
返回一个匹配器,该匹配器使用任意函数,该函数为实际值返回true或false. [...]
printOnFailure(String message) → void
Prints message if and when the current test fails. [...]
prints(dynamic matcher) Matcher
与打印与matcher文本的功能 matcher . [...]
pumpEventQueue({int times}) Future
返回一个Future ,该Future事件循环运行给定times (默认为20)后完成. [...]
rectMoreOrLessEquals(Rect value, {double epsilon: precisionErrorTolerance}) Matcher
断言两个Rect是相等的,并且处于一定的允许误差范围内. [...]
registerException(dynamic error, [StackTrace stackTrace]) → void
注册为当前测试捕获的异常.
rendersOnPhysicalModel({BoxShape shape, BorderRadius borderRadius, double elevation}) Matcher
断言Finder找到一个根RenderObject为RenderPhysicalModelRenderPhysicalShape的对象 . [...]
rendersOnPhysicalShape({ShapeBorder shape, double elevation}) Matcher
断言Finder查找单个对象,其根RenderObject为RenderPhysicalShape ,该对象使用ShapeBorderClipper进行裁剪以将shape作为其裁剪器. 如果elevation为非零断言RenderPhysicalShape.elevation等于elevation .
reportExpectCall(StackTrace stack, List<DiagnosticsNode> information) int
Report call site for expect() call. Returns the number of frames that should be elided if a stack were to be modified to hide the expect call, or zero if no such call was found. [...]
same(dynamic expected) Matcher
如果值与expected实例相同 ,则使用same来返回匹配项.
setUp(dynamic body()) → void
注册要在测试之前运行的功能. [...]
setUpAll(dynamic body()) → void
注册一个要在所有测试之前运行一次的功能. [...]
simulateKeyDownEvent(LogicalKeyboardKey key, {String platform, PhysicalKeyboardKey physicalKey}) Future<void>
模拟通过系统通道发送硬件按下事件. [...]
simulateKeyUpEvent(LogicalKeyboardKey key, {String platform, PhysicalKeyboardKey physicalKey}) Future<void>
模拟通过系统通道发送硬件启动事件. [...]
spawnHybridCode(String dartCode, {Object message, bool stayAlive: false}) StreamChannel
生成运行给定dartCode的VM隔离,该隔离将作为Dart库的内容加载. [...]
spawnHybridUri(dynamic uri, {Object message, bool stayAlive: false}) StreamChannel
为给定的uri生成VM隔离,它可以是UriString . [...]
startsWith(String prefixString) Matcher
返回一个匹配器,如果match参数是字符串,则匹配器以prefixString .
stringContainsInOrder(List<String> substrings) Matcher
返回匹配匹配,如果匹配参数是一个字符串,包含给定的列表substrings的相对顺序. [...]
tearDown(dynamic body()) → void
注册要在测试后运行的功能. [...]
tearDownAll(dynamic body()) → void
注册一个要在所有测试后运行一次的功能. [...]
test(Object description, dynamic body(), {String testOn, Timeout timeout, dynamic skip, dynamic tags, Map<String, dynamic> onPlatform, int retry}) → void
使用给定的描述(转换为字符串)和正文创建一个新的测试用例. [...]
@isTest
testWidgets(String description, WidgetTesterCallback callback, {bool skip: false, Timeout timeout, Duration initialTimeout, bool semanticsEnabled: true, TestVariant<Object> variant: const DefaultTestVariant()}) → void
在Flutter测试环境中运行callback . [...]
@isTest
throwsA(dynamic matcher) Matcher
这可以用于匹配三种对象: [...]
unorderedEquals(Iterable expected) Matcher
返回其相匹配的匹配器可迭代具有相同的长度和相同的元件为s expected ,但不一定在相同的顺序. [...]
unorderedMatches(Iterable expected) Matcher
返回一个与Iterable匹配的匹配器,其元素按expected与匹配器匹配,但顺序不一定相同. [...]
within<T>({num distance, T from, DistanceFunction<T> distanceFunction}) Matcher
断言两个值彼此之间在一定距离内. [...]
wrapMatcher(dynamic x) Matcher
Takes an argument and returns an equivalent Matcher. [...]

Enums

EnginePhase
WidgetTester.pumpWidgetTestWidgetsFlutterBinding.pump可以达到的阶段. [...]
LiveTestWidgetsFlutterBindingFramePolicy
LiveTestWidgetsFlutterBinding如何绘制框架的可用策略. [...]
TestBindingEventSource
可以生成到达测试绑定的指针事件的系统部分. [...]
TextInputAction
用户已请求执行文本输入控件的操作. [...]

Typedefs

AnyDistanceFunction(Null a, Null b) num
各种类型T的DistanceFunction <T>实例的并集类型. [...]
DistanceFunction<T>(T a, T b) num
计算两个值之间的距离. [...]
ElementPredicate(Element element) bool
CommonFinders.byElementPredicate的签名.
ErrorFormatter(dynamic actual, Matcher matcher, String reason, Map matchState, bool verbose) String
用于函数的类型,该函数可用于在期望失败时建立错误报告.
@ 不推荐使用 ("将从0.13.0中删除.")
EventDispatcher(PointerEvent event, HitTestResult result) Future<void>
可以分派事件并返回将来在事件分派完成时完成的回调的签名.
Func0<T>() → T
Func1<T, A>([A a]) → T
Func2<T, A, B>([A a, B b]) → T
Func3<T, A, B, C>([A a, B b, C c]) → T
Func4<T, A, B, C, D>([A a, B b, C c, D d]) → T
Func5<T, A, B, C, D, E>([A a, B b, C c, D d, E e]) → T
Func6<T, A, B, C, D, E, F>([A a, B b, C c, D d, E e, F f]) → T
HitTester(Offset location) HitTestResult
在给定位置执行命中测试的回调的签名.
TestExceptionReporter(FlutterErrorDetails details, String testDescription) → void
reportTestException回调的签名.
WidgetPredicate(Widget widget) bool
CommonFinders.byWidgetPredicate的签名.
WidgetTesterCallback(WidgetTester widgetTester) Future<void>
回调到testWidgetsBenchmarkWidgets的签名.