identifier property

String? identifier
final

Provides an identifier for the semantics node in native accessibility hierarchy.

This value is not exposed to the users of the app.

It's usually used for UI testing with tools that work by querying the native accessibility, like UIAutomator, XCUITest, or Appium. It can be matched with CommonFinders.bySemanticsIdentifier.

When set, this property implicitly forces the creation of a new SemanticsNode (equivalent to setting container to true in Semantics). This ensures the identifier is always attached to its own node and is not merged into an ancestor.

On Android, this is used for AccessibilityNodeInfo.setViewIdResourceName. It'll be appear in accessibility hierarchy as resource-id.

On iOS, this will set UIAccessibilityElement.accessibilityIdentifier.

On web, this will set a flt-semantics-identifier attribute on the DOM element that corresponds to the semantics node.

Implementation

final String? identifier;