Improve test coverage for the Dwalin class

EPadronU · Aug 15, 2024 · 5b40066 · 5b40066
1 parent 09fff82
commit 5b40066
Show file tree

Hide file tree

Showing 48 changed files with 373 additions and 136 deletions.
diff --git a/docs/apidocs/allclasses-index.html b/docs/apidocs/allclasses-index.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>All Classes and Interfaces (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="class index">
 <meta name="generator" content="javadoc/AllClassesIndexWriter">
 <link rel="stylesheet" type="text/css" href="resource-files/jquery-ui.min.css" title="Style">

diff --git a/docs/apidocs/allpackages-index.html b/docs/apidocs/allpackages-index.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>All Packages (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="package index">
 <meta name="generator" content="javadoc/AllPackagesIndexWriter">
 <link rel="stylesheet" type="text/css" href="resource-files/jquery-ui.min.css" title="Style">

diff --git a/docs/apidocs/com/github/epadronu/dwalin/core/AbstractionLayer.html b/docs/apidocs/com/github/epadronu/dwalin/core/AbstractionLayer.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>AbstractionLayer (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="declaration: package: com.github.epadronu.dwalin.core, interface: AbstractionLayer">
 <meta name="generator" content="javadoc/ClassWriter">
 <link rel="stylesheet" type="text/css" href="../../../../../resource-files/jquery-ui.min.css" title="Style">

diff --git a/docs/apidocs/com/github/epadronu/dwalin/core/Component.html b/docs/apidocs/com/github/epadronu/dwalin/core/Component.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>Component (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="declaration: package: com.github.epadronu.dwalin.core, class: Component">
 <meta name="generator" content="javadoc/ClassWriter">
 <link rel="stylesheet" type="text/css" href="../../../../../resource-files/jquery-ui.min.css" title="Style">

diff --git a/docs/apidocs/com/github/epadronu/dwalin/core/Dwalin.html b/docs/apidocs/com/github/epadronu/dwalin/core/Dwalin.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>Dwalin (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="declaration: package: com.github.epadronu.dwalin.core, class: Dwalin">
 <meta name="generator" content="javadoc/ClassWriter">
 <link rel="stylesheet" type="text/css" href="../../../../../resource-files/jquery-ui.min.css" title="Style">
@@ -113,13 +113,31 @@ <h2>Field Summary</h2>
 <div class="col-second even-row-color"><code><a href="#AT_VERIFICATION_SUPPLIER_CANNOT_BE_NULL_MESSAGE" class="member-name-link">AT_VERIFICATION_SUPPLIER_CANNOT_BE_NULL_MESSAGE</a></code></div>
 <div class="col-last even-row-color">
 <div class="block">
- Error message displayed when attempting to open a page with a null "at verification" supplier.</div>
+ Error message displayed when attempting to navigate to a page with a null "at verification" supplier.</div>
 </div>
 <div class="col-first odd-row-color"><code>static final <a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></code></div>
-<div class="col-second odd-row-color"><code><a href="#URL_SUPPLIER_CANNOT_BE_NULL_MESSAGE" class="member-name-link">URL_SUPPLIER_CANNOT_BE_NULL_MESSAGE</a></code></div>
+<div class="col-second odd-row-color"><code><a href="#DESCRIPTION_CANNOT_BE_NULL_MESSAGE" class="member-name-link">DESCRIPTION_CANNOT_BE_NULL_MESSAGE</a></code></div>
 <div class="col-last odd-row-color">
 <div class="block">
- Error message displayed when attempting to open a page with a null URL supplier.</div>
+ Error message displayed when attempting to attach a screenshot associated with a null description.</div>
+</div>
+<div class="col-first even-row-color"><code>static final <a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></code></div>
+<div class="col-second even-row-color"><code><a href="#SUBJECT_CANNOT_BE_NULL_MESSAGE" class="member-name-link">SUBJECT_CANNOT_BE_NULL_MESSAGE</a></code></div>
+<div class="col-last even-row-color">
+<div class="block">
+ Error message displayed when attempting to attach a screenshot of a null subject.</div>
+</div>
+<div class="col-first odd-row-color"><code>static final <a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></code></div>
+<div class="col-second odd-row-color"><code><a href="#URL_CANNOT_BE_NULL_MESSAGE" class="member-name-link">URL_CANNOT_BE_NULL_MESSAGE</a></code></div>
+<div class="col-last odd-row-color">
+<div class="block">
+ Error message displayed when attempting to navigate to a page with a null URL.</div>
+</div>
+<div class="col-first even-row-color"><code>static final <a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></code></div>
+<div class="col-second even-row-color"><code><a href="#URL_SUPPLIER_CANNOT_BE_NULL_MESSAGE" class="member-name-link">URL_SUPPLIER_CANNOT_BE_NULL_MESSAGE</a></code></div>
+<div class="col-last even-row-color">
+<div class="block">
+ Error message displayed when attempting to navigate to a page with a null URL supplier.</div>
 </div>
 </div>
 </section>
@@ -183,7 +201,7 @@ <h3>URL_SUPPLIER_CANNOT_BE_NULL_MESSAGE</h3>
 <div class="horizontal-scroll">
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></span>&nbsp;<span class="element-name">URL_SUPPLIER_CANNOT_BE_NULL_MESSAGE</span></div>
 <div class="block"><p>
- Error message displayed when attempting to open a page with a null URL supplier.
+ Error message displayed when attempting to navigate to a page with a null URL supplier.
  </p></div>
 <dl class="notes">
 <dt>See Also:</dt>
@@ -197,12 +215,69 @@ <h3>URL_SUPPLIER_CANNOT_BE_NULL_MESSAGE</h3>
 </section>
 </li>
 <li>
+<section class="detail" id="URL_CANNOT_BE_NULL_MESSAGE">
+<h3>URL_CANNOT_BE_NULL_MESSAGE</h3>
+<div class="horizontal-scroll">
+<div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></span>&nbsp;<span class="element-name">URL_CANNOT_BE_NULL_MESSAGE</span></div>
+<div class="block"><p>
+ Error message displayed when attempting to navigate to a page with a null URL.
+ </p></div>
+<dl class="notes">
+<dt>See Also:</dt>
+<dd>
+<ul class="tag-list">
+<li><a href="../../../../../constant-values.html#com.github.epadronu.dwalin.core.Dwalin.URL_CANNOT_BE_NULL_MESSAGE">Constant Field Values</a></li>
+</ul>
+</dd>
+</dl>
+</div>
+</section>
+</li>
+<li>
+<section class="detail" id="SUBJECT_CANNOT_BE_NULL_MESSAGE">
+<h3>SUBJECT_CANNOT_BE_NULL_MESSAGE</h3>
+<div class="horizontal-scroll">
+<div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></span>&nbsp;<span class="element-name">SUBJECT_CANNOT_BE_NULL_MESSAGE</span></div>
+<div class="block"><p>
+ Error message displayed when attempting to attach a screenshot of a null subject.
+ </p></div>
+<dl class="notes">
+<dt>See Also:</dt>
+<dd>
+<ul class="tag-list">
+<li><a href="../../../../../constant-values.html#com.github.epadronu.dwalin.core.Dwalin.SUBJECT_CANNOT_BE_NULL_MESSAGE">Constant Field Values</a></li>
+</ul>
+</dd>
+</dl>
+</div>
+</section>
+</li>
+<li>
+<section class="detail" id="DESCRIPTION_CANNOT_BE_NULL_MESSAGE">
+<h3>DESCRIPTION_CANNOT_BE_NULL_MESSAGE</h3>
+<div class="horizontal-scroll">
+<div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></span>&nbsp;<span class="element-name">DESCRIPTION_CANNOT_BE_NULL_MESSAGE</span></div>
+<div class="block"><p>
+ Error message displayed when attempting to attach a screenshot associated with a null description.
+ </p></div>
+<dl class="notes">
+<dt>See Also:</dt>
+<dd>
+<ul class="tag-list">
+<li><a href="../../../../../constant-values.html#com.github.epadronu.dwalin.core.Dwalin.DESCRIPTION_CANNOT_BE_NULL_MESSAGE">Constant Field Values</a></li>
+</ul>
+</dd>
+</dl>
+</div>
+</section>
+</li>
+<li>
 <section class="detail" id="AT_VERIFICATION_SUPPLIER_CANNOT_BE_NULL_MESSAGE">
 <h3>AT_VERIFICATION_SUPPLIER_CANNOT_BE_NULL_MESSAGE</h3>
 <div class="horizontal-scroll">
 <div class="member-signature"><span class="modifiers">public static final</span>&nbsp;<span class="return-type"><a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></span>&nbsp;<span class="element-name">AT_VERIFICATION_SUPPLIER_CANNOT_BE_NULL_MESSAGE</span></div>
 <div class="block"><p>
- Error message displayed when attempting to open a page with a null "at verification" supplier.
+ Error message displayed when attempting to navigate to a page with a null "at verification" supplier.
  </p></div>
 <dl class="notes">
 <dt>See Also:</dt>
@@ -229,7 +304,8 @@ <h3>navigateTo</h3>
 <div class="horizontal-scroll">
 <div class="member-signature"><span class="annotations">@CheckReturnValue
 @Nonnull
-</span><span class="modifiers">public static</span>&nbsp;<span class="type-parameters">&lt;P extends <a href="NavigablePage.html" title="interface in com.github.epadronu.dwalin.core">NavigablePage</a>&gt;</span>&nbsp;<span class="return-type">P</span>&nbsp;<span class="element-name">navigateTo</span><wbr><span class="parameters">(<a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/Class.html" title="class or interface in java.lang" class="external-link">Class</a>&lt;P&gt;&nbsp;pageObjectClass)</span></div>
+</span><span class="modifiers">public static</span>&nbsp;<span class="type-parameters">&lt;P extends <a href="NavigablePage.html" title="interface in com.github.epadronu.dwalin.core">NavigablePage</a>&gt;</span>&nbsp;<span class="return-type">P</span>&nbsp;<span class="element-name">navigateTo</span><wbr><span class="parameters">(@Nonnull
+ <a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/Class.html" title="class or interface in java.lang" class="external-link">Class</a>&lt;P&gt;&nbsp;pageObjectClass)</span></div>
 <div class="block"><p>
  Navigates to the specified page.
  </p></div>
@@ -240,6 +316,8 @@ <h3>navigateTo</h3>
 <dd><code>pageObjectClass</code> - a <code>Class&lt;P&gt;</code> representing the type of the page to navigate to</dd>
 <dt>Returns:</dt>
 <dd>a new instance of the specified page</dd>
+<dt>Throws:</dt>
+<dd><code><a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/NullPointerException.html" title="class or interface in java.lang" class="external-link">NullPointerException</a></code> - if <code>pageObjectClass</code> is <code>null</code></dd>
 </dl>
 </div>
 </section>
@@ -269,12 +347,16 @@ <h3 id="navigateTo(com.github.epadronu.dwalin.core.NavigablePage[])">navigateTo<
 <section class="detail" id="attachScreenshotToAllureReport(org.openqa.selenium.TakesScreenshot)">
 <h3>attachScreenshotToAllureReport</h3>
 <div class="horizontal-scroll">
-<div class="member-signature"><span class="modifiers">public static</span>&nbsp;<span class="return-type">void</span>&nbsp;<span class="element-name">attachScreenshotToAllureReport</span><wbr><span class="parameters">(org.openqa.selenium.TakesScreenshot&nbsp;subject)</span></div>
+<div class="member-signature"><span class="annotations">@CheckReturnValue
+</span><span class="modifiers">public static</span>&nbsp;<span class="return-type">void</span>&nbsp;<span class="element-name">attachScreenshotToAllureReport</span><wbr><span class="parameters">(@Nonnull
+ org.openqa.selenium.TakesScreenshot&nbsp;subject)</span></div>
 <div class="block">Captures a screenshot from the given <code>TakesScreenshot</code> subject and attaches it
  to the Allure report with a default description.</div>
 <dl class="notes">
 <dt>Parameters:</dt>
 <dd><code>subject</code> - the <code>TakesScreenshot</code> instance from which the screenshot will be captured</dd>
+<dt>Throws:</dt>
+<dd><code><a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/NullPointerException.html" title="class or interface in java.lang" class="external-link">NullPointerException</a></code> - if <code>subject</code> is <code>null</code></dd>
 </dl>
 </div>
 </section>
@@ -283,14 +365,19 @@ <h3>attachScreenshotToAllureReport</h3>
 <section class="detail" id="attachScreenshotToAllureReport(org.openqa.selenium.TakesScreenshot,java.lang.String)">
 <h3>attachScreenshotToAllureReport</h3>
 <div class="horizontal-scroll">
-<div class="member-signature"><span class="modifiers">public static</span>&nbsp;<span class="return-type">void</span>&nbsp;<span class="element-name">attachScreenshotToAllureReport</span><wbr><span class="parameters">(org.openqa.selenium.TakesScreenshot&nbsp;subject,
+<div class="member-signature"><span class="annotations">@CheckReturnValue
+</span><span class="modifiers">public static</span>&nbsp;<span class="return-type">void</span>&nbsp;<span class="element-name">attachScreenshotToAllureReport</span><wbr><span class="parameters">(@Nonnull
+ org.openqa.selenium.TakesScreenshot&nbsp;subject,
+ @Nonnull
  <a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a>&nbsp;description)</span></div>
 <div class="block">Captures a screenshot from the given <code>TakesScreenshot</code> subject and attaches it
  to the Allure report with the specified description.</div>
 <dl class="notes">
 <dt>Parameters:</dt>
 <dd><code>subject</code> - the <code>TakesScreenshot</code> instance from which the screenshot will be captured</dd>
 <dd><code>description</code> - the description to be used for the screenshot attachment in the Allure report</dd>
+<dt>Throws:</dt>
+<dd><code><a href="https://docs.oracle.com/en/java/javase/22/docs/api/java.base/java/lang/NullPointerException.html" title="class or interface in java.lang" class="external-link">NullPointerException</a></code> - if either <code>subject</code> or <code>description</code> are <code>null</code></dd>
 </dl>
 </div>
 </section>

diff --git a/docs/apidocs/com/github/epadronu/dwalin/core/ElementComponent.html b/docs/apidocs/com/github/epadronu/dwalin/core/ElementComponent.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>ElementComponent (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="declaration: package: com.github.epadronu.dwalin.core, class: ElementComponent">
 <meta name="generator" content="javadoc/ClassWriter">
 <link rel="stylesheet" type="text/css" href="../../../../../resource-files/jquery-ui.min.css" title="Style">

diff --git a/docs/apidocs/com/github/epadronu/dwalin/core/ElementGuard.html b/docs/apidocs/com/github/epadronu/dwalin/core/ElementGuard.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>ElementGuard (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="declaration: package: com.github.epadronu.dwalin.core, class: ElementGuard">
 <meta name="generator" content="javadoc/ClassWriter">
 <link rel="stylesheet" type="text/css" href="../../../../../resource-files/jquery-ui.min.css" title="Style">

diff --git a/docs/apidocs/com/github/epadronu/dwalin/core/GuardedComponent.html b/docs/apidocs/com/github/epadronu/dwalin/core/GuardedComponent.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>GuardedComponent (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="declaration: package: com.github.epadronu.dwalin.core, class: GuardedComponent">
 <meta name="generator" content="javadoc/ClassWriter">
 <link rel="stylesheet" type="text/css" href="../../../../../resource-files/jquery-ui.min.css" title="Style">

diff --git a/docs/apidocs/com/github/epadronu/dwalin/core/NavigablePage.html b/docs/apidocs/com/github/epadronu/dwalin/core/NavigablePage.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>NavigablePage (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="declaration: package: com.github.epadronu.dwalin.core, interface: NavigablePage">
 <meta name="generator" content="javadoc/ClassWriter">
 <link rel="stylesheet" type="text/css" href="../../../../../resource-files/jquery-ui.min.css" title="Style">

diff --git a/docs/apidocs/com/github/epadronu/dwalin/core/Page.html b/docs/apidocs/com/github/epadronu/dwalin/core/Page.html
@@ -1,11 +1,11 @@
 <!DOCTYPE HTML>
 <html lang>
 <head>
-<!-- Generated by javadoc (22) on Tue Aug 13 08:42:23 COT 2024 -->
+<!-- Generated by javadoc (22) on Thu Aug 15 13:51:36 COT 2024 -->
 <title>Page (Dwalin 1.0-SNAPSHOT API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-08-13">
+<meta name="dc.created" content="2024-08-15">
 <meta name="description" content="declaration: package: com.github.epadronu.dwalin.core, interface: Page">
 <meta name="generator" content="javadoc/ClassWriter">
 <link rel="stylesheet" type="text/css" href="../../../../../resource-files/jquery-ui.min.css" title="Style">