TesterTaskRelevant class
Widget that annotates a UI element as relevant to a specific test task
This widget uses the "Clarity Pattern" - a zero-overhead marker that wraps a child widget without affecting its rendering or layout. The annotation is discoverable at runtime via TaskAnnotationRegistry and can be used by AI agents and automation tools to identify task-relevant UI elements.
Example usage:
TesterTaskRelevant(
taskId: 'TASK-123',
focusAreaId: 'auth-flow',
versionRange: VersionRange.parse('^1.2.0'),
completionTrigger: CompletionTrigger.onTap,
semanticLabels: ['login', 'authentication'],
child: ElevatedButton(
onPressed: () => login(),
child: Text('Login'),
),
)
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- RenderObjectWidget
- SingleChildRenderObjectWidget
- TesterTaskRelevant
Constructors
-
TesterTaskRelevant({required String taskId, required Widget? child, String? focusAreaId, VersionRange? versionRange, CompletionTrigger completionTrigger = CompletionTrigger.manual, int requiredInteractionCount = 1, List<
String> semanticLabels = const [], Map<String, dynamic> metadata = const {}, Key? key}) -
Creates a task annotation wrapper
const
Properties
- child → Widget?
-
The widget below this widget in the tree.
finalinherited
- completionTrigger → CompletionTrigger
-
How this annotation triggers task completion
final
- focusAreaId → String?
-
Optional focus area ID
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
-
metadata
→ Map<
String, dynamic> -
Custom metadata for extensibility
final
- requiredInteractionCount → int
-
Number of interactions required to trigger completion
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
semanticLabels
→ List<
String> -
Semantic labels for AI discoverability
final
- taskId → String
-
Task ID this annotation is linked to
final
- versionRange → VersionRange?
-
Version range this annotation is valid for
final
Methods
-
createElement(
) → SingleChildRenderObjectElement -
RenderObjectWidgets always inflate to a RenderObjectElement subclass.
inherited
-
createRenderObject(
BuildContext context) → RenderObject -
Creates an instance of the RenderObject class that this
RenderObjectWidget represents, using the configuration described by this
RenderObjectWidget.
override
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of DiagnosticsNode objects describing this node's
children.
inherited
-
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node.
inherited
-
didUnmountRenderObject(
covariant RenderObject renderObject) → void -
This method is called when a RenderObject that was previously
associated with this widget is removed from the render tree.
The provided RenderObject will be of the same type as the one created by
this widget's createRenderObject method.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toDiagnosticsNode(
{String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode -
Returns a debug representation of the object that is used by debugging
tools and by DiagnosticsNode.toStringDeep.
inherited
-
toString(
{DiagnosticLevel minLevel = DiagnosticLevel.info}) → String -
A string representation of this object.
inherited
-
toStringDeep(
{String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String -
Returns a string representation of this node and its descendants.
inherited
-
toStringShallow(
{String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a one-line detailed description of the object.
inherited
-
toStringShort(
) → String -
A short, textual description of this widget.
inherited
-
updateRenderObject(
BuildContext context, covariant RenderTaskAnnotation renderObject) → void -
Copies the configuration described by this RenderObjectWidget to the
given RenderObject, which will be of the same type as returned by this
object's createRenderObject.
override
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited