feat: Implement TabSheetElement.getTabLabels() (#8108)

* #2022 Implement TabSheetElement.getTabCaptions()

* #2022 fix formatting

* TabsElement: rename getTabCaptions() to getTabLabels()

* fix formatting

* minor

* remove HasLabel interface

* clarify JavaDoc

---------

Co-authored-by: Tatu Lund <[email protected]>
Co-authored-by: Sascha Ißbrücker <[email protected]>

Author: 3 people

vaadin-tabs-flow-parent/vaadin-tabs-flow-integration-tests/src/test/java/com/vaadin/flow/component/tabs/tests/TabSheetIT.java

@@ -93,4 +93,10 @@ public void unselect_shouldThrowOnGetContent() {
         Assert.assertThrows(NoSuchElementException.class,
                 () -> tabSheet.getContent());
     }
+
+    @Test
+    public void getTabLabels_shouldReturnTwoTabs() {
+        Assert.assertArrayEquals(new String[] { "Tab one", "Tab two" },
+                tabSheet.getTabLabels().toArray());
+    }
 }

vaadin-tabs-flow-parent/vaadin-tabs-testbench/src/main/java/com/vaadin/flow/component/tabs/testbench/TabElement.java

@@ -29,4 +29,12 @@ public boolean isEnabled() {
         return !getPropertyBoolean("disabled");
     }
 
+    /**
+     * Gets the label of the tab.
+     * 
+     * @return the label of the tab
+     */
+    public String getLabel() {
+        return getText();
+    }
 }

vaadin-tabs-flow-parent/vaadin-tabs-testbench/src/main/java/com/vaadin/flow/component/tabs/testbench/TabSheetElement.java

@@ -15,6 +15,8 @@
  */
 package com.vaadin.flow.component.tabs.testbench;
 
+import java.util.List;
+
 import org.openqa.selenium.By;
 import org.openqa.selenium.NoSuchElementException;
 
@@ -101,4 +103,12 @@ public TabsElement getTabs() {
         return $(TabsElement.class).first();
     }
 
+    /**
+     * Returns the labels of all tab elements, in the order they appear.
+     *
+     * @return a list of tab labels, one for every tab. Not null, may be empty.
+     */
+    public List<String> getTabLabels() {
+        return getTabs().getTabLabels();
+    }
 }

vaadin-tabs-flow-parent/vaadin-tabs-testbench/src/main/java/com/vaadin/flow/component/tabs/testbench/TabsElement.java

@@ -85,14 +85,33 @@ public TabElement getTabElement(String text) throws NoSuchElementException {
      *         or -1 if no match was found
      */
     public int getTab(String text) {
-        List<TestBenchElement> children = getPropertyElements("children");
+        List<TabElement> children = getTabs();
         for (int i = 0; i < children.size(); i++) {
-            String tabText = children.get(i).wrap(TabElement.class).getText();
-            if (text.equals(tabText)) {
+            String tabLabel = children.get(i).getLabel();
+            if (text.equals(tabLabel)) {
                 return i;
             }
         }
         return -1;
     }
 
+    /**
+     * Returns the child tabs.
+     *
+     * @return the list of child tab elements. Not null, may be empty.
+     */
+    public List<TabElement> getTabs() {
+        List<TestBenchElement> children = getChildren();
+        return children.stream().map(it -> it.wrap(TabElement.class)).toList();
+    }
+
+    /**
+     * Returns the labels of all tab elements, in the order they appear.
+     *
+     * @return a list of tab labels, one for every tab. Not null, may be empty.
+     */
+    public List<String> getTabLabels() {
+        final List<TabElement> tabElements = getTabs();
+        return tabElements.stream().map(TabElement::getLabel).toList();
+    }
 }