[plugin-web-app] Deprecate elementName locator type (#5289)

vividus-framework · Aug 12, 2024 · c1daf2f · c1daf2f
1 parent 2a0f4db
commit c1daf2f
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 1 deletion.
diff --git a/docs/modules/plugins/partials/plugin-web-app-locators.adoc b/docs/modules/plugins/partials/plugin-web-app-locators.adoc
@@ -77,10 +77,18 @@ and moves handling of spaces up to user
 |input element with @type="checkbox" and text value
 |checkboxName(allow)
 
-|`elementName`
+a|`elementName`
+[WARNING]
+====
+This locator type is deprecated and will be removed in VIVIDUS 0.7.0. Use `name` locator type instead.
+====
 |any attribute or text value
 |elementName(OK)
 
+|`name`
+|Locate elements where any attribute or text value matches the specified search value.
+|name(OK)
+
 |`shadowCssSelector`
 |chain of css selectors, separated by `;`, where first value - selector for upper shadow host, last value - target element selector
 |shadowCssSelector(.upperHost; #innerHost1; #innerHost2; .targetValue)

diff --git a/vividus-plugin-web-app/src/main/java/org/vividus/ui/web/action/search/WebLocatorType.java b/vividus-plugin-web-app/src/main/java/org/vividus/ui/web/action/search/WebLocatorType.java
@@ -111,6 +111,7 @@ public By buildBy(String value)
     FIELD_TEXT("Field text", FieldTextFilter.class),
     FIELD_TEXT_PART("Field text part", FieldTextPartFilter.class),
     DROP_DOWN_TEXT("Drop down text", DropDownTextFilter.class),
+    @Deprecated(since = "0.6.14", forRemoval = true)
     ELEMENT_NAME("Element name", ElementNameSearch.class),
     NAME("Name", ElementNameSearch.class),
     PARTIAL_LINK_TEXT("Partial link text", ByLocatorSearch.class)