Update version 1.9.0 released

Author: anhtester

README.md

@@ -4,7 +4,7 @@
 
 ## Automation Framework Selenium Java with TestNG building by Anh Tester
 
-**SOME FEATURES IN FRAMEWORK**
+🔆 **SOME FEATURES IN FRAMEWORK**
 
 1. Run the parallel test case
 2. Read Config from Properties file
@@ -19,24 +19,26 @@
 11. Main Keyword: WebUI (call common function)
 12. Sample test all function in WebUI keyword
 13. Send message/report to Telegram Bot
+14. Run Selenium Grid (remote)
 
-### **SYSTEM REQUIREMENTS**
+### ✳️ **SYSTEM REQUIREMENTS**
 
-- **JDK All Version**
+- **JDK All Version** (recommend JDK >=11)
 - Chrome Browser, Edge Browser, Firefox Browser
-- Setup **Allure**:
+- Run well on the **Windows** platform
+- Setup **Allure ENV**:
   https://mvnrepository.com/artifact/io.qameta.allure/allure-java-commons
   or
   https://anhtester.com/blog/selenium-java/selenium-java-tai-nguyen-cai-dat-moi-truong)
   Download jar and setting Variable Environment as Java JDK
 
   ![image](https://user-images.githubusercontent.com/87883620/161661705-b8706957-5a26-4faf-8ddf-2f9aef78418e.png)
 
-- **IntelliJ IDEA** is the best choice (to change JDK version)
+- **IntelliJ IDEA** is the best choice (easy change the JDK version)
 
 ![image](https://user-images.githubusercontent.com/87883620/161707184-7ad558f2-0d7d-4851-bfd6-2796d4e46593.png)
 
-### **HOW TO USE**
+### ✳️ **HOW TO USE**
 
 **1. Run parallel the test case**
 
@@ -61,13 +63,12 @@
 
 ![image](https://user-images.githubusercontent.com/87883620/161657754-c29b1ee9-f2fb-44b3-bee0-9f425a7cab6f.png)
 
-- Pdf Report
+- **Pdf Report**
 
 ![image](https://user-images.githubusercontent.com/87883620/194396654-5b01cb68-161a-4caf-824d-b57cd6091586.png)
 ![image](https://user-images.githubusercontent.com/87883620/194396689-ac5381cc-8689-4ce0-8c7f-d2487047faec.png)
 ![image](https://user-images.githubusercontent.com/87883620/194396707-ed1308a0-e4bf-4cac-b5b6-0fde44c81091.png)
 
-
 **4. Allure Report**
 
 - Open Terminal: **_allure serve target/allure-results_**
@@ -113,8 +114,7 @@
 
 **8. Read data test from Excel file**
 
-- Create function with annotaion **DataProvider** on **
-  src/test/java/anhtester/com/projects/website/crm/dataprovider/DataProviderManager.java**
+- Create function with annotaion **DataProvider** on **src/test/java/anhtester/com/projects/website/crm/dataprovider/DataProviderManager.java**
 - Read excel with Map and Hashtable
 
 **9. Base function in the package**
@@ -147,7 +147,7 @@
 
 - Setup in src/main/java/anhtester/com/report/TelegramManager.java
 - Example: src/test/java/anhtester/com/projects/website/crm/testcases/TestSimpleCode.java
-- Call in TestListener at onFinish TelegramManager.sendReportPath();
+- Call in TestListener at onFinish TelegramManager.sendReportPath()
 
 ======How to get Token and start Bot=======
 
@@ -170,6 +170,50 @@
 }
 ```
 
+**14. Use Selenium Grid**
+
+### ---------------- Download and Install --------------
+
+1. Download Selenium Grid 4: https://www.selenium.dev/downloads/
+
+(tải bản Latest stable version)
+
+**selenium-server-4.6.0.jar** (updated 04/11/2022)
+
+2. Thiết đặt PATH cho driver của từng Browser:
+
+Xem link làm
+theo: https://www.selenium.dev/documentation/webdriver/getting_started/install_drivers/#2-the-path-environment-variable
+
+🔆 Đặt file **selenium-server-4.6.0.jar** vào thư mục nào đó và mở CMD tại thư mục đó lên
+
+### ---------------------- Run default -------------------
+
+✅ Mở 1 hub với 1 node mặc định (port 4444)
+
+> java -jar selenium-server-4.6.0.jar standalone
+
+### -------------------- Run multi Node ----------------
+
+✅ Mở 1 hub với 3 node: (chạy 4 lệnh mở 4 CMD nhé)
+
+> java -jar selenium-server-4.6.0.jar hub
+
+> java -jar selenium-server-4.6.0.jar node --port 5556
+
+> java -jar selenium-server-4.6.0.jar node --port 6667
+
+> java -jar selenium-server-4.6.0.jar node --port 7778
+
+
+**NOTE: Thực thi nhiều lệnh thì mở nhiều CMD**
+
+### ----------- Edit Grid in Config.properties -----------
+
+> REMOTE_URL=192.168.1.13 (url Grid của bạn)
+
+> REMOTE_PORT=4444 (port của Grid)
+
 ### Project structure
 
 ```

pom.xml

@@ -16,12 +16,13 @@
         <java-compiler.version>11</java-compiler.version>
         <maven-surefire-plugin.version>3.0.0-M7</maven-surefire-plugin.version>
         <maven-compiler-plugin.version>3.10.1</maven-compiler-plugin.version>
-        <selenium.version>4.5.0</selenium.version>
-        <testng.version>7.6.1</testng.version>
+        <selenium.version>4.6.0</selenium.version>
+        <testng.version>7.4.0</testng.version>
         <webdrivermanager.version>5.3.0</webdrivermanager.version>
         <aspectjweaver.version>1.9.9.1</aspectjweaver.version>
         <ashot.version>1.5.4</ashot.version>
         <log4j.version>2.19.0</log4j.version>
+        <slf4j.version>2.0.3</slf4j.version>
         <allure-testng.version>2.19.0</allure-testng.version>
         <allure-maven.version>2.10.0</allure-maven.version>
         <allure-environment-writer.version>1.0.0</allure-environment-writer.version>

src/main/java/anhtester/com/driver/BrowserFactory.java

@@ -7,8 +7,6 @@
 
 import anhtester.com.constants.FrameworkConstants;
 import anhtester.com.exceptions.HeadlessNotSupportedException;
-import io.github.bonigarcia.wdm.WebDriverManager;
-import io.github.bonigarcia.wdm.config.DriverManagerType;
 import org.openqa.selenium.MutableCapabilities;
 import org.openqa.selenium.WebDriver;
 import org.openqa.selenium.chrome.ChromeDriver;
@@ -27,7 +25,7 @@ public enum BrowserFactory {
     CHROME {
         @Override
         public WebDriver createDriver() {
-            WebDriverManager.getInstance(DriverManagerType.CHROME).setup();
+            //WebDriverManager.getInstance(DriverManagerType.CHROME).setup();
 
             return new ChromeDriver(getOptions());
         }
@@ -44,8 +42,8 @@ public ChromeOptions getOptions() {
     }, FIREFOX {
         @Override
         public WebDriver createDriver() {
-            WebDriverManager.getInstance(DriverManagerType.FIREFOX).setup();
-            
+            //WebDriverManager.getInstance(DriverManagerType.FIREFOX).setup();
+
             return new FirefoxDriver(getOptions());
         }
 
@@ -59,7 +57,7 @@ public FirefoxOptions getOptions() {
     }, EDGE {
         @Override
         public WebDriver createDriver() {
-            WebDriverManager.getInstance(DriverManagerType.EDGE).setup();
+            //WebDriverManager.getInstance(DriverManagerType.EDGE).setup();
 
             return new EdgeDriver(getOptions());
         }
@@ -74,7 +72,7 @@ public EdgeOptions getOptions() {
     }, SAFARI {
         @Override
         public WebDriver createDriver() {
-            WebDriverManager.getInstance(DriverManagerType.SAFARI).setup();
+            //WebDriverManager.getInstance(DriverManagerType.SAFARI).setup();
 
             return new SafariDriver(getOptions());
         }

src/main/java/anhtester/com/keyword/WebUI.java

@@ -478,11 +478,10 @@ public static ChromeOptions notificationsBlock() {
      * @param by       là element thuộc kiểu By
      * @param filePath đường dẫn tuyệt đối đến file trên máy tính của bạn
      */
-    public static void uploadFileForm(By by, String filePath) {
-        if (ACTIVE_PAGE_LOADED.trim().toLowerCase().equals("true")) {
-            waitForPageLoaded();
-        }
-        sleep(WAIT_SLEEP_STEP);
+    @Step("Upload File With Local Form")
+    public static void uploadFileWithLocalForm(By by, String filePath) {
+        smartWait();
+
         Actions action = new Actions(DriverManager.getDriver());
         //Click để mở form upload
         action.moveToElement(getWebElement(by)).click().perform();
@@ -543,6 +542,13 @@ public static void uploadFileForm(By by, String filePath) {
             robot.keyPress(KeyEvent.VK_ENTER);
             robot.keyRelease(KeyEvent.VK_ENTER);
         }
+
+        Log.info("Upload File With Local Form: " + filePath);
+        if (ExtentTestManager.getExtentTest() != null) {
+            ExtentReportManager.info("Upload File With Local Form: " + filePath);
+        }
+        AllureManager.saveTextLog("Upload File With Local Form: " + filePath);
+
     }
 
     /**
@@ -551,21 +557,40 @@ public static void uploadFileForm(By by, String filePath) {
      * @param by       truyền vào element dạng đối tượng By
      * @param filePath đường dẫn tuyệt đối đến file
      */
-    public static void uploadFileSendkeys(By by, String filePath) {
+    @Step("Upload File with SendKeys")
+    public static void uploadFileWithSendKeys(By by, String filePath) {
         smartWait();
-        waitForElementPresent(by).sendKeys(filePath);
+
+        waitForElementVisible(by).sendKeys(filePath);
+
+        Log.info("Upload File with SendKeys");
+        if (ExtentTestManager.getExtentTest() != null) {
+            ExtentReportManager.info("Upload File with SendKeys");
+        }
+        AllureManager.saveTextLog("Upload File with SendKeys");
+
     }
 
+    @Step("Get Current URL")
     public static String getCurrentUrl() {
         smartWait();
         Log.info("Current Page Url: " + DriverManager.getDriver().getCurrentUrl());
+        if (ExtentTestManager.getExtentTest() != null) {
+            ExtentReportManager.info("Current Page Url: " + DriverManager.getDriver().getCurrentUrl());
+        }
+        AllureManager.saveTextLog("Current Page Url: " + DriverManager.getDriver().getCurrentUrl());
         return DriverManager.getDriver().getCurrentUrl();
     }
 
+    @Step("Get Page Title")
     public static String getPageTitle() {
         smartWait();
         String title = DriverManager.getDriver().getTitle();
         Log.info("Current Page Title: " + DriverManager.getDriver().getTitle());
+        if (ExtentTestManager.getExtentTest() != null) {
+            ExtentReportManager.info("Get Current Page Title: " + DriverManager.getDriver().getTitle());
+        }
+        AllureManager.saveTextLog("Get Current Page Title: " + DriverManager.getDriver().getTitle());
         return title;
     }
 

src/main/java/anhtester/com/report/AllureManager.java

@@ -27,12 +27,12 @@ public static void setAllureEnvironmentInformation() {
                         put("Test URL", FrameworkConstants.URL_CRM).
                         put("Target Execution", FrameworkConstants.TARGET).
                         put("Global Timeout", String.valueOf(FrameworkConstants.WAIT_DEFAULT)).
-                        put("Headless Dode", FrameworkConstants.HEADLESS).
+                        put("Page Load Timeout", String.valueOf(FrameworkConstants.WAIT_PAGE_LOADED)).
+                        put("Headless Mode", FrameworkConstants.HEADLESS).
                         put("Local Browser", String.valueOf(Browser.CHROME)).
                         put("Remote URL", FrameworkConstants.REMOTE_URL).
                         put("Remote Port", FrameworkConstants.REMOTE_PORT).
                         build());
-
 
     }
 

src/test/java/anhtester/com/listeners/TestListener.java

@@ -70,9 +70,9 @@ public void onStart(ISuite iSuite) {
         AllureManager.setAllureEnvironmentInformation();
         ExtentReportManager.initReports();
         System.out.println("========= INSTALLED CONFIGURATION DATA =========");
-        System.out.println(" ");
-        Log.info("Start suite: " + iSuite.getName());
-        iSuite.setAttribute("WebDriver", DriverManager.getDriver());
+        System.out.println("");
+        Log.info("Starting Suite: " + iSuite.getName());
+
 //        //Gọi hàm startRecord video trong CaptureHelpers class
 //        if (VIDEO_RECORD.toLowerCase().trim().equals(YES)) {
 //            CaptureHelpers.startRecord(iSuite.getName());
@@ -81,7 +81,7 @@ public void onStart(ISuite iSuite) {
 
     @Override
     public void onFinish(ISuite iSuite) {
-        Log.info("End suite testing " + iSuite.getName());
+        Log.info("End Suite: " + iSuite.getName());
         WebUI.stopSoftAssertAll();
         //Kết thúc Suite và thực thi Extents Report, đóng gói Folder report và send mail
         ExtentReportManager.flushReports();
@@ -117,7 +117,7 @@ public CategoryType[] getCategoryType(ITestResult iTestResult) {
 
     @Override
     public void onTestStart(ITestResult iTestResult) {
-        Log.info("Test case: " + getTestName(iTestResult) + " test is starting...");
+        Log.info("Test case: " + getTestName(iTestResult) + " is starting...");
         count_totalTCs = count_totalTCs + 1;
 
         ExtentReportManager.createTest(iTestResult.getName());
@@ -165,11 +165,11 @@ public void onTestFailure(ITestResult iTestResult) {
         Log.error(iTestResult.getThrowable());
 
         AllureManager.takeScreenshotToAttachOnAllureReport();
+        AllureManager.saveTextLog(iTestResult.getThrowable().toString());
 
         //Extent report screenshot file and log
         ExtentReportManager.addScreenShot(Status.FAIL, getTestName(iTestResult));
-        ExtentReportManager.logMessage(Status.FAIL, "Test case: " + getTestName(iTestResult) + " is failed.");
-        ExtentReportManager.logMessage(Status.FAIL, iTestResult.getThrowable());
+        ExtentReportManager.logMessage(Status.FAIL, iTestResult.getThrowable().toString());
 
         if (VIDEO_RECORD.toLowerCase().trim().equals(YES)) {
             screenRecorder.stopRecording(true);

src/test/java/anhtester/com/projects/website/crm/testcases/TestHandle.java

@@ -160,7 +160,7 @@ public void testUploadFileSendKeys() {
 
         String filePath = Helpers.getCurrentDir() + "src\\test\\resources\\testdata\\TxtFileData.txt";
 
-        WebUI.uploadFileSendkeys(inputFileUpload, filePath);
+        WebUI.uploadFileWithSendKeys(inputFileUpload, filePath);
 
         WebUI.sleep(4);
     }
@@ -176,7 +176,7 @@ public void testUploadFileFormDialog() {
 
         String filePath = Helpers.getCurrentDir() + "src\\test\\resources\\testdata\\TxtFileData.txt";
 
-        WebUI.uploadFileForm(divFileUpload, filePath);
+        WebUI.uploadFileWithLocalForm(divFileUpload, filePath);
 
         WebUI.sleep(4);
     }
@@ -337,15 +337,15 @@ public void handleUploadFile() {
         final String path2 = Helpers.getCurrentDir() + "src\\test\\resources\\testdata\\LoginCSV.csv";
 
         //Cách 1 sendKeys link từ source
-        WebUI.uploadFileSendkeys(By.xpath("//input[@id='uploadFile']"), path1);
+        WebUI.uploadFileWithSendKeys(By.xpath("//input[@id='uploadFile']"), path1);
         WebUI.verifyElementTextContains(By.xpath("//p[@id='uploadedFilePath']"), "DOCX_File_01ABC.docx");
         WebUI.sleep(1);
         WebUI.reloadPage();
         WebUI.waitForPageLoaded();
         WebUI.sleep(1);
 
         //Cách 2 mở form local máy nên file là trong ổ đĩa máy tính
-        WebUI.uploadFileForm(By.xpath("//input[@id='uploadFile']"), path2);
+        WebUI.uploadFileWithLocalForm(By.xpath("//input[@id='uploadFile']"), path2);
         WebUI.verifyElementTextContains(By.xpath("//p[@id='uploadedFilePath']"), "LoginCSV.csv");
         WebUI.sleep(3);
     }

src/test/resources/config/config.properties

@@ -15,13 +15,14 @@ ACTIVE_PAGE_LOADED=true
 WAIT_SLEEP_STEP=0
 # Browser default chrome, edge, firefox, safari
 BROWSER=chrome
-# target execution: local or remote
-TARGET=local
 # headless mode only for chrome or firefox and local execution
 HEADLESS=false
 URL_CRM=https://rise.fairsketch.com/signin
+
+# target execution: local or remote
+TARGET=local
 # grid url and port
-REMOTE_URL=localhost
+REMOTE_URL=192.168.1.13
 REMOTE_PORT=4444
 # Report information
 PROJECT_NAME=Automation Framework Selenium | Anh Tester