Changelog #

0.18.0 #

Breaking: Add act.dragUntilVisible() now moves the target in the center of the viewport (one additional drag). parameter moveStep is now optional, default to half the scrollable size. The direction can be controlled with bool toStart.
Fix: Restore support for integration_tests - don't generate the timeline HTML
New: Add support for flutter test --platform chrome - don't generate the timeline HTML and screenshot paths
New: Added warning when spot<GenericWidget>() can't find a widget because it is actually looking for GenericWidget<dynamic>
Improvement: Moved timeline screenshots into build/timeline/<test_name>/screenshots/ for easier browser image resolution. Fixes issues with Firefox.
Improvement: Improve error message of act.tap when multiple or no widgets are found
Fix: existsAtLeastNTimes(0) now reports a correct error message

Changes for WidgetSelector

Improved: .snapshotWidget(), .snapshotState(), .snapshotElement(), .snapshotRenderBox() and .snapshotRenderObject() now add a single consistent entry each to the timeline with consistent messages.

Changes for WidgetSnapshot

New: discoveredRenderObject
New: discoveredRenderObjects
New: discoveredRenderBox
New: discoveredRenderBoxes
New: removeQuantityConstraints()

Changes for class Screenshot (big breaking update!)

Fix screenshot filenames on windows (remove colons)
New: width, height, pixelRatio, name
New: readBytes(), readPngBytes(), readPngBytesSync() gives access to raw bytes
Deprecated: file property. Still returns File but signature now returns dynamic for web support. Use createTempPngFile() or raw byte APIs instead
New: createTempPngFile() writes the screenshot to a temporary file and returns the absolute file path
New: List<ScreenshotAnnotation> annotations, addAnnotation(), removeAnnotation() each layer is now separately available
New: flattenedImage() merges all layers into a single image

0.17.0 #

Timeline is now generated with Jaspr #76
New: act.tapAt() #80
New Timeline.addEvent() now returns the TimelineEventId id
New Timeline.updateEvent(id) and Timeline.removeEvent(id)
Fix: Added events to timeline while being off #88
Fix: Export stateProp #93
Improved screenshot detail page in timeline #91, #92

0.16.0 #

Add snapshotState<S>() final state = spot<MyContainer>().snapshotState<MyContainerState>()
Add snapshotRenderBox()
Export WidgetPresence
Add @useResult to .atMost(N), .atLeast(N), .amount(N) and .existsAtMostNTimes(N) to prevent missing assertions
Fix existsAtLeastNTimes dumping the widget tree to console
Fix image rendering with TimelineMode.always
Add Timeline to /README.md
Add act to /README.md

0.15.0 #

Add loadAppFonts() to display your app fonts on screenshots #66
Add loadFont() to load a fonts from a file. Useful when your app depends on preinstalled system fonts (loadFont('Comic Sans', [r'C:\Windows\Fonts\comic.ttf'])) #66
New direct access to properties from WidgetSelector #71
- spot<MyWidget>().getWidgetProp(widgetProp('color', (widget) => widget.color));
- spot<_MyContainer>().getStateProp(stateProp<String, _MyContainerState>('innerValue', (s) => s.innerValue));
- spot<_MyContainer>().getRenderObjectProp(renderObjectProp<Size, RenderBox>('size', (r) => r.size));
New getStateProp and stateProp to access state properties #71 spot<_MyContainer>().existsOnce().getStateProp(stateProp('innerValue', (_MyContainerState s) => s.innerValue));
New timeline mode TimelineMode.always to always print a timeline after each test #68
Deprecate TimelineMode.record in favor of TimelineMode.reportOnError (which is the default) #68
Timeline now shows partial tap warnings #69
Never show big widget tree dumps in console, only in Timeline HTML report #70
act.tap() now shows a Crosshair on the screenshot
Fix code samples of whereWidgetProp(), whereElementProp() and whereRenderObjectProp() #67

0.14.0 #

New: Timeline! Failing tests now print a timeline with screenshots of all interactions (actions and assertions) as HTML report #57
act.tap now checks for multiple tappable position when the center is not tappable for some reason #60
act.tap now reports a useful error when the widget is 0px/0px or invisible #61
Become Compatible with Flutter 3.27 and add nightly tests against master

0.13.0 #

Add act.dragUntilVisible() #59

0.12.1 #

Support for Flutter 3.22
Remove unused dependencies #55

0.12.0 #

Breaking Offstage support. By default Offstage widgets are not found by spot<W>(). Use spotOffstage().spot<W>() to find them. spotAllWidgets() returns onstage and offstage widgets. Use .overrideWidgetPresence(WidgetPresence.offstage) to modify a WidgetSelector to search for offstage, onstage or combined #45
New: act.enterText(spot<TextField>(), 'Hello World!') allows to enter text into a EditableText #51
Negating parents is not yet supported (spot<ListView>().withParent(spot<Scaffold>().atMost(0))). It now throws to prevent unexpected behavior. #50
act.tap(spot<ElevatedButton>()) now pumps automatically after the tap #52

0.11.0 #

Add support for Flutter 3.20
Update checks to 0.3.0 #48
Remove deprecated property selector from withProp() and hasProp(). Use elementSelector instead
Widen test_api version range to include 0.7.X

0.10.0 #

High-level API changes #

Breaking spotText('dash') can now return multiple widgets
New: .atLeast(n) and .atMost(n) and .amount(n) to force the number of expected widgets. .atMost(0) can be used to test that a widget does not exist!
Deprecated: spotSingle<W>() is now deprecated. Use spot<W>() instead, or spot<W>().atMost(1) to indicate that only a single widget is expected.
Fix: .first() and .last()
New: .atIndex(n) allows to get the widget at a specific index (when multiple are found)
Deprecate: allWidgets in favor of spotAllWidgets() to avoid conflicts with local variables
New: getDiagnosticProp<T>('name') for easy access to the values of a diagnostic property #40
New: hasEffectiveTextStyle, withEffectiveTextStyleMatching(), withEffectiveTextStyle() #36, #38
Improve: WidgetSelector.toString() has been improved, has now separators for stages and adds braces. Example: Center with child SizedBox ❯ with parent (Scaffold ᗕ Row)
Added tons of documentation and examples

Advanced API changes #

Those changes can be breaking for packages that depend on spot or advanced usages, but should not affect most users.

Breaking WidgetSelector now has List<ElementFilter> stages, replacing the previous props, parents, children and elementFilters.
Breaking WidgetSelector constructor and copyWith signature changed, reflecting the new properties. createElementFilters(), createCandidateGenerator() and toStringWithoutParents() have been removed.
WidgetSelector now has a quantityConstraint property (deprecates expectedQuantity) that allows setting the min and max number of expected widgets.
WidgetSelector replaces SingleWidgetSelector and MultiWidgetSelector
Breaking Quantity assertions like .doesNotExist() or .existsOnce() now return WidgetMatcher/MultiWidgetMatcher instead of WidgetSnapshot. To get the WidgetSnapshot use snapshot() instead.
Breaking Remove WidgetSelector.cast because it lost information and was untested
Breaking PropFilter has been renamed to PredicateFilter
Breaking PredicateWithDescription has been removed
Breaking CandidateGenerator has been removed
Explicitly export all classes/extensions/functions to prevent accidental leaks of internal APIs

0.10.0-beta.3 #

This release contains breaking changes to the "internal" WidgetSelector API. Unless you are using the WidgetSelector directly, you should not be affected by this.

The end-user spot API is not affected.

Breaking WidgetSelector now has List<ElementFilter> stages, replacing the previous props, parents, children and elementFilters.
Breaking WidgetSelector constructor and copyWith signature changed, reflecting the new properties. createElementFilters(), createCandidateGenerator() and toStringWithoutParents() have been removed.
Breaking PropFilter has been renamed to PredicateFilter
Breaking PredicateWithDescription has been removed
Breaking CandidateGenerator has been removed
WidgetSelector.toString() has been improved, has now separators for stages and adds braces. Example: Center with child SizedBox ❯ with parent (Scaffold ᗕ Row)
Fix .atIndex(n) to be executed at the right time, not after all other filters.

0.10.0-beta.2 #

New getDiagnosticProp<T>('name') for easy access to the values of a diagnostic property #40
New hasEffectiveTextStyle, withEffectiveTextStyleMatching(), withEffectiveTextStyle() #36, #38
Tons of documentation and examples #37, #39
Restructure of internal files

0.10.0-beta.1 #

Eventually Breaking, but only the class names. The end user API stays the same.

spotSingle<W>() is now deprecated. Use spot<W>() instead, or spot<W>().atMost(1) to indicate that only a single widget is expected.
WidgetSelector replaces SingleWidgetSelector and MultiWidgetSelector
WidgetSelector now has a quantityConstraint property (deprecates expectedQuantity) that allows setting the min and max number of expected widgets.
New: .atIndex(n) allows to get the widget at a specific index (when multiple are found)
Fix: .first() and .last() now work after calling .copyWith()
Breaking Quantity assertions like .doesNotExist() or .existsOnce() now return WidgetMatcher/MultiWidgetMatcher instead of WidgetSnapshot. To get the WidgetSnapshot use snapshot() instead.
spotText('a') can now return multiple widgets
Breaking remove WidgetSelector.cast because it lost information and was untested

0.7.0 #

New prop API with hasWidgetProp() makes it easy to filter and assert properties of Widgets. This replaces the old hasProp() method which was based on way to complicated package:checks context.

// Old ⛈️
spotSingle<Checkbox>().existsOnce().hasProp(
    selector: (e) => e.context.nest(
      () => ['Checkbox', 'value'],
      (e) => Extracted.value((e.widget as Checkbox).value),
    ),
    match: (it) => it.equals(true),
  );

// New ✨
spotSingle<Checkbox>().existsOnce().hasWidgetProp(
    prop: widgetProp('value', (widget) => widget.value),
    match: (value) => value.isTrue(),
  );

The prop API is also available for Element and RenderObject.

├── Interface "NamedWidgetProp" added 
├── Interface "NamedElementProp" added 
├── Interface "NamedRenderObjectProp" added 
├── Function "widgetProp" added 
├── Function "elementProp" added 
├── Function "renderObjectProp" added 
├─┬ Class SelectorQueries
│ ├── Method "whereWidgetProp" added 
│ ├── Method "whereElementProp" added 
│ └── Method "whereRenderObjectProp" added 
└─┬ Class WidgetMatcherExtensions
├── Method "getWidgetProp" added 
├── Method "hasWidgetProp" added 
├── Method "getElementProp" added 
├── Method "hasElementProp" added 
├── Method "getRenderObjectProp" added 
└── Method "hasRenderObjectProp" added

Never miss asserting your WidgetSelector. All methods returning a WidgetSelector are now annotated with @useResult. This will cause a lint warning when you only define a WidgetSelector without asserting it.

spot<FloatingActionButton>().withChild(spotIcon(Icons.add)); // warning, no assertion
  
final plusFab = spot<FloatingActionButton>().withChild(spotIcon(Icons.add)); // ok, assigned
spot<FloatingActionButton>().withChild(spotIcon(Icons.add)).existsOnce(); // ok, asserted

It is now easy to directly access the Widget of a SingleWidgetSelector with snapshotWidget(). It also works for the associated Element and RenderObject. Use snapshotElement() and snapshotRenderObject().
```
-final checkbox = spotSingle<Checkbox>().snapshot().widget;
+final checkbox = spotSingle<Checkbox>().snapshotWidget();
print(checkbox.checkColor);
```

0.6.0 #

Add matchers .existsAtMostOnce() and .existsAtMostNTimes(x) #19
Add selector .withParent(parent)/.withParents([...]) #21
Add selector .withChild(child)/.withChildren([...]) #21
Child selectors now only match children #22
You can call act.tap() now with any WidgetSelector that returns a single widget #23

0.5.0 #

Breaking act.tap is now async, use await act.tap() #17
New: spotText('foo') finds any text on screen using "contains". The new AnyText widget combines Text, SelectableText, RichText and EditableText #18
New: spotTextWhere((text) => ) allows to match text with custom logic #18
Deprecated: spotSingleText and spotTexts are deprecated in favor of spotText and the basic spot<Text>(), spot<SelectableText>(), ... #18
Fix: hasProp matcher can now check for null values with (it) => it.isNull() #18
Improvement: withDiagnosticProp now falls back to the default value of a DiagnosticNode #18

0.4.3 #

Remove unused dependencies. Fixes incompatibility with latest test_api versions #55

0.4.2 #

Switch to renderView.size to get the window size

0.4.1 #

Added screenshot methods #14

/// Takes a screenshot of the entire window
await takeScreenshot();
  
/// Takes a screenshot of a single Screen/Widget
final homePage = spotSingle<HomePage>();
await takeScreenshot(selector: homePage);
  
/// Use it as extension
await spotSingle<HomePage>().takeScreenshot();

Export all types from checks.dart which are required to use hasProp
Update for Flutter 3.13

0.4.0 #

Added act.tap(button) to tap widgets #9
Raise min Flutter version to 3.10.0
Switch to the official checks package #12
Rename SingleWidgetSnapshot.discoveredElements -> SingleWidgetSnapshot.discoveredElement #11

0.3.3 #

Widen test_api range to support Flutter 3.22

0.3.2 #

Export all types from checks.dart which are required to use hasProp

0.3.1 #

Fix compilation error with Flutter 3.0.0

0.3.0 #

spotTexts now matches EditableText and SelectableText #5
spotTexts now has generic type <W> instead of static Text. This changes the return type from MultiWidgetSelector<Text> -> MultiWidgetSelector<W> #5
Changed signature of SingleWidgetSelector.withProp and MultiWidgetSelector.withProp.
New matchers for EditableText, ListTile, SelectableText

0.2.2 #

Support for Flutter 3.0.0 / Dart 2.17

0.2.1 #

Fix WidgetSelector with parents that have parents #4
Require all children selector to match, not just one #4

0.2.0 #

Reworked spot API #3
Allow defining WidgetSelector with children
Allow defining WidgetSelector with parents
Interop with Finder API
Match properties of widgets (via DiagnosticsNode)
Allow matching of nested properties (with checks API)
Generate code for custom properties for Flutter widgets
Allow generating code for properties of 3rd party widgets

0.1.0-preview.2 #

Update package description
Add issue_tracker link
Add example folder

0.1.0-preview.1 #

Extraction from wiredash repository

spot 0.18.0 spot: ^0.18.0 copied to clipboard

Metadata