mirror of
https://github.com/flutter/flutter.git
synced 2026-02-20 02:29:02 +08:00
* Refactor widget test framework
Instead of:
```dart
test("Card Collection smoke test", () {
testWidgets((WidgetTester tester) {
```
...you now say:
```dart
testWidgets("Card Collection smoke test", (WidgetTester tester) {
```
Instead of:
```dart
expect(tester, hasWidget(find.text('hello')));
```
...you now say:
```dart
expect(find.text('hello'), findsOneWidget);
```
Instead of the previous API (exists, widgets, widget, stateOf,
elementOf, etc), you now have the following comprehensive API. All these
are functions that take a Finder, except the all* properties.
* `any()` - true if anything matches, c.f. `Iterable.any`
* `allWidgets` - all the widgets in the tree
* `widget()` - the one and only widget that matches the finder
* `firstWidget()` - the first widget that matches the finder
* `allElements` - all the elements in the tree
* `element()` - the one and only element that matches the finder
* `firstElement()` - the first element that matches the finder
* `allStates` - all the `State`s in the tree
* `state()` - the one and only state that matches the finder
* `firstState()` - the first state that matches the finder
* `allRenderObjects` - all the render objects in the tree
* `renderObject()` - the one and only render object that matches the finder
* `firstRenderObject()` - the first render object that matches the finder
There's also `layers' which returns the list of current layers.
`tap`, `fling`, getCenter, getSize, etc, take Finders, like the APIs
above, and expect there to only be one matching widget.
The finders are:
* `find.text(String text)`
* `find.widgetWithText(Type widgetType, String text)`
* `find.byKey(Key key)`
* `find.byType(Type type)`
* `find.byElementType(Type type)`
* `find.byConfig(Widget config)`
* `find.byWidgetPredicate(WidgetPredicate predicate)`
* `find.byElementPredicate(ElementPredicate predicate)`
The matchers (for `expect`) are:
* `findsNothing`
* `findsWidgets`
* `findsOneWidget`
* `findsNWidgets(n)`
* `isOnStage`
* `isOffStage`
* `isInCard`
* `isNotInCard`
Benchmarks now use benchmarkWidgets instead of testWidgets.
Also, for those of you using mockers, `serviceMocker` now automatically
handles the binding initialization.
This patch also:
* changes how tests are run so that we can more easily swap the logic
out for a "real" mode instead of FakeAsync.
* introduces CachingIterable.
* changes how flutter_driver interacts with the widget tree to use the
aforementioned new API rather than ElementTreeTester, which is gone.
* removes ElementTreeTester.
* changes the semantics of a test for scrollables because we couldn't
convince ourselves that the old semantics made sense; it only worked
before because flushing the microtasks after every event was broken.
* fixes the flushing of microtasks after every event.
* Reindent the tests
* Fix review comments
258 lines
7.8 KiB
Dart
258 lines
7.8 KiB
Dart
// Copyright 2015 The Chromium Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
import 'package:flutter_test/flutter_test.dart';
|
|
import 'package:flutter/rendering.dart';
|
|
import 'package:flutter/widgets.dart';
|
|
import 'package:test/test.dart';
|
|
|
|
import '../rendering/rendering_tester.dart';
|
|
|
|
void main() {
|
|
testWidgets('Can construct an empty Stack', (WidgetTester tester) {
|
|
tester.pumpWidget(new Stack());
|
|
});
|
|
|
|
testWidgets('Can construct an empty Centered Stack', (WidgetTester tester) {
|
|
tester.pumpWidget(new Center(child: new Stack()));
|
|
});
|
|
|
|
testWidgets('Can change position data', (WidgetTester tester) {
|
|
Key key = new Key('container');
|
|
|
|
tester.pumpWidget(
|
|
new Stack(
|
|
children: <Widget>[
|
|
new Positioned(
|
|
left: 10.0,
|
|
child: new Container(
|
|
key: key,
|
|
width: 10.0,
|
|
height: 10.0
|
|
)
|
|
)
|
|
]
|
|
)
|
|
);
|
|
|
|
Element container;
|
|
StackParentData parentData;
|
|
|
|
container = tester.element(find.byKey(key));
|
|
parentData = container.renderObject.parentData;
|
|
expect(parentData.top, isNull);
|
|
expect(parentData.right, isNull);
|
|
expect(parentData.bottom, isNull);
|
|
expect(parentData.left, equals(10.0));
|
|
expect(parentData.width, isNull);
|
|
expect(parentData.height, isNull);
|
|
|
|
tester.pumpWidget(
|
|
new Stack(
|
|
children: <Widget>[
|
|
new Positioned(
|
|
right: 10.0,
|
|
child: new Container(
|
|
key: key,
|
|
width: 10.0,
|
|
height: 10.0
|
|
)
|
|
)
|
|
]
|
|
)
|
|
);
|
|
|
|
container = tester.element(find.byKey(key));
|
|
parentData = container.renderObject.parentData;
|
|
expect(parentData.top, isNull);
|
|
expect(parentData.right, equals(10.0));
|
|
expect(parentData.bottom, isNull);
|
|
expect(parentData.left, isNull);
|
|
expect(parentData.width, isNull);
|
|
expect(parentData.height, isNull);
|
|
});
|
|
|
|
testWidgets('Can remove parent data', (WidgetTester tester) {
|
|
Key key = new Key('container');
|
|
Container container = new Container(key: key, width: 10.0, height: 10.0);
|
|
|
|
tester.pumpWidget(new Stack(children: <Widget>[ new Positioned(left: 10.0, child: container) ]));
|
|
Element containerElement = tester.element(find.byKey(key));
|
|
|
|
StackParentData parentData;
|
|
parentData = containerElement.renderObject.parentData;
|
|
expect(parentData.top, isNull);
|
|
expect(parentData.right, isNull);
|
|
expect(parentData.bottom, isNull);
|
|
expect(parentData.left, equals(10.0));
|
|
expect(parentData.width, isNull);
|
|
expect(parentData.height, isNull);
|
|
|
|
tester.pumpWidget(new Stack(children: <Widget>[ container ]));
|
|
containerElement = tester.element(find.byKey(key));
|
|
|
|
parentData = containerElement.renderObject.parentData;
|
|
expect(parentData.top, isNull);
|
|
expect(parentData.right, isNull);
|
|
expect(parentData.bottom, isNull);
|
|
expect(parentData.left, isNull);
|
|
expect(parentData.width, isNull);
|
|
expect(parentData.height, isNull);
|
|
});
|
|
|
|
testWidgets('Can align non-positioned children', (WidgetTester tester) {
|
|
Key child0Key = new Key('child0');
|
|
Key child1Key = new Key('child1');
|
|
|
|
tester.pumpWidget(
|
|
new Center(
|
|
child: new Stack(
|
|
children: <Widget>[
|
|
new Container(key: child0Key, width: 20.0, height: 20.0),
|
|
new Container(key: child1Key, width: 10.0, height: 10.0)
|
|
],
|
|
alignment: const FractionalOffset(0.5, 0.5)
|
|
)
|
|
)
|
|
);
|
|
|
|
Element child0 = tester.element(find.byKey(child0Key));
|
|
final StackParentData child0RenderObjectParentData = child0.renderObject.parentData;
|
|
expect(child0RenderObjectParentData.offset, equals(const Offset(0.0, 0.0)));
|
|
|
|
Element child1 = tester.element(find.byKey(child1Key));
|
|
final StackParentData child1RenderObjectParentData = child1.renderObject.parentData;
|
|
expect(child1RenderObjectParentData.offset, equals(const Offset(5.0, 5.0)));
|
|
});
|
|
|
|
testWidgets('Can construct an empty IndexedStack', (WidgetTester tester) {
|
|
tester.pumpWidget(new IndexedStack());
|
|
});
|
|
|
|
testWidgets('Can construct an empty Centered IndexedStack', (WidgetTester tester) {
|
|
tester.pumpWidget(new Center(child: new IndexedStack()));
|
|
});
|
|
|
|
testWidgets('Can construct an IndexedStack', (WidgetTester tester) {
|
|
int itemCount = 3;
|
|
List<int> itemsPainted;
|
|
|
|
Widget buildFrame(int index) {
|
|
itemsPainted = <int>[];
|
|
List<Widget> items = new List<Widget>.generate(itemCount, (int i) {
|
|
return new CustomPaint(
|
|
child: new Text('$i'),
|
|
painter: new TestCallbackPainter(
|
|
onPaint: () { itemsPainted.add(i); }
|
|
)
|
|
);
|
|
});
|
|
return new Center(child: new IndexedStack(children: items, index: index));
|
|
}
|
|
|
|
tester.pumpWidget(buildFrame(0));
|
|
expect(find.text('0'), findsOneWidget);
|
|
expect(find.text('1'), findsOneWidget);
|
|
expect(find.text('2'), findsOneWidget);
|
|
expect(itemsPainted, equals([0]));
|
|
|
|
tester.pumpWidget(buildFrame(1));
|
|
expect(itemsPainted, equals([1]));
|
|
|
|
tester.pumpWidget(buildFrame(2));
|
|
expect(itemsPainted, equals([2]));
|
|
});
|
|
|
|
testWidgets('Can hit test an IndexedStack', (WidgetTester tester) {
|
|
Key key = new Key('indexedStack');
|
|
int itemCount = 3;
|
|
List<int> itemsTapped;
|
|
|
|
Widget buildFrame(int index) {
|
|
itemsTapped = <int>[];
|
|
List<Widget> items = new List<Widget>.generate(itemCount, (int i) {
|
|
return new GestureDetector(child: new Text('$i'), onTap: () { itemsTapped.add(i); });
|
|
});
|
|
return new Center(child: new IndexedStack(children: items, key: key, index: index));
|
|
}
|
|
|
|
tester.pumpWidget(buildFrame(0));
|
|
expect(itemsTapped, isEmpty);
|
|
tester.tap(find.byKey(key));
|
|
expect(itemsTapped, [0]);
|
|
|
|
tester.pumpWidget(buildFrame(2));
|
|
expect(itemsTapped, isEmpty);
|
|
tester.tap(find.byKey(key));
|
|
expect(itemsTapped, [2]);
|
|
});
|
|
|
|
testWidgets('Can set width and height', (WidgetTester tester) {
|
|
Key key = new Key('container');
|
|
|
|
BoxDecoration kBoxDecoration = new BoxDecoration(
|
|
backgroundColor: new Color(0xFF00FF00)
|
|
);
|
|
|
|
tester.pumpWidget(
|
|
new Stack(
|
|
children: <Widget>[
|
|
new Positioned(
|
|
left: 10.0,
|
|
width: 11.0,
|
|
height: 12.0,
|
|
child: new DecoratedBox(key: key, decoration: kBoxDecoration)
|
|
)
|
|
]
|
|
)
|
|
);
|
|
|
|
Element box;
|
|
RenderBox renderBox;
|
|
StackParentData parentData;
|
|
|
|
box = tester.element(find.byKey(key));
|
|
renderBox = box.renderObject;
|
|
parentData = renderBox.parentData;
|
|
expect(parentData.top, isNull);
|
|
expect(parentData.right, isNull);
|
|
expect(parentData.bottom, isNull);
|
|
expect(parentData.left, equals(10.0));
|
|
expect(parentData.width, equals(11.0));
|
|
expect(parentData.height, equals(12.0));
|
|
expect(parentData.offset.dx, equals(10.0));
|
|
expect(parentData.offset.dy, equals(0.0));
|
|
expect(renderBox.size.width, equals(11.0));
|
|
expect(renderBox.size.height, equals(12.0));
|
|
|
|
tester.pumpWidget(
|
|
new Stack(
|
|
children: <Widget>[
|
|
new Positioned(
|
|
right: 10.0,
|
|
width: 11.0,
|
|
height: 12.0,
|
|
child: new DecoratedBox(key: key, decoration: kBoxDecoration)
|
|
)
|
|
]
|
|
)
|
|
);
|
|
|
|
box = tester.element(find.byKey(key));
|
|
renderBox = box.renderObject;
|
|
parentData = renderBox.parentData;
|
|
expect(parentData.top, isNull);
|
|
expect(parentData.right, equals(10.0));
|
|
expect(parentData.bottom, isNull);
|
|
expect(parentData.left, isNull);
|
|
expect(parentData.width, equals(11.0));
|
|
expect(parentData.height, equals(12.0));
|
|
expect(parentData.offset.dx, equals(779.0));
|
|
expect(parentData.offset.dy, equals(0.0));
|
|
expect(renderBox.size.width, equals(11.0));
|
|
expect(renderBox.size.height, equals(12.0));
|
|
});
|
|
|
|
}
|