Upgrade to Selenium 4.38.0; add JavaDoc (#312)

Author: sbabcoc

selenium4Deps.gradle

@@ -25,16 +25,16 @@ sourceSets {
 dependencies {
   constraints {
     api 'com.nordstrom.tools:testng-foundation:5.2.1-j11'
-    api 'org.seleniumhq.selenium:selenium-grid:4.36.0'
-    api 'org.seleniumhq.selenium:selenium-support:4.36.0'
-    api 'org.seleniumhq.selenium:selenium-chrome-driver:4.36.0'
-    api 'org.seleniumhq.selenium:selenium-edge-driver:4.36.0'
-    api 'org.seleniumhq.selenium:selenium-firefox-driver:4.36.0'
+    api 'org.seleniumhq.selenium:selenium-grid:4.38.0'
+    api 'org.seleniumhq.selenium:selenium-support:4.38.0'
+    api 'org.seleniumhq.selenium:selenium-chrome-driver:4.38.0'
+    api 'org.seleniumhq.selenium:selenium-edge-driver:4.38.0'
+    api 'org.seleniumhq.selenium:selenium-firefox-driver:4.38.0'
     api 'org.seleniumhq.selenium:selenium-opera-driver:4.4.0'
-    api 'org.seleniumhq.selenium:selenium-safari-driver:4.36.0'
-    api 'com.nordstrom.ui-tools:htmlunit-remote:4.36.1'
-    api 'org.seleniumhq.selenium:htmlunit3-driver:4.36.1'
-    api 'org.htmlunit:htmlunit:4.15.0'
+    api 'org.seleniumhq.selenium:selenium-safari-driver:4.38.0'
+    api 'com.nordstrom.ui-tools:htmlunit-remote:4.38.0'
+    api 'org.seleniumhq.selenium:htmlunit3-driver:4.38.0'
+    api 'org.htmlunit:htmlunit:4.18.0'
     api 'com.codeborne:phantomjsdriver:1.5.0'
     api 'org.apache.httpcomponents:httpclient:4.5.14'
     api 'org.eclipse.jetty:jetty-servlet:9.4.57.v20241219'

src/main/java/com/nordstrom/automation/selenium/examples/IOSPage.java

@@ -40,25 +40,52 @@ public By locator() {
         }
     }
 
+    /**
+     * Populate the two addend fields and tap the 'Compute Sum' button.
+     * 
+     * @param a addend A
+     * @param b addend B
+     * @return sum shown by the application
+     */
     public int computeSum(int a, int b) {
     	updateIntegerA(a);
     	updateIntegerB(b);
     	return computeSum();
     }
 
+    /**
+     * Update the value of addend A.
+     * 
+     * @param a new value 
+     */
     public void updateIntegerA(int a) {
     	findElement(Using.INTEGER_A).sendKeys(Integer.toString(a));
     }
 
+    /**
+     * Update the value of addend B.
+     * 
+     * @param a new value 
+     */
     public void updateIntegerB(int b) {
     	findElement(Using.INTEGER_B).sendKeys(Integer.toString(b));
     }
 
+    /**
+     * Tap the 'Compute Sum' button.
+     * 
+     * @return sum shown by the application
+     */
     public int computeSum() {
     	findElement(Using.COMPUTE_SUM).click();
     	return getAnswerAsInt();
     }
 
+    /**
+     * Get displayed sum as an integer.
+     * 
+     * @return displayed sum; 0 if integer conversion fails
+     */
     public int getAnswerAsInt() {
     	try {
     		return Integer.parseInt(getAnswerAsString());
@@ -67,6 +94,11 @@ public int getAnswerAsInt() {
     	}
     }
 
+    /**
+     * Get displayed sum as a string.
+     * 
+     * @return displayed sum as a string
+     */
     public String getAnswerAsString() {
     	return findElement(Using.ANSWER).getText();
     }