[Selenium Java] Bài 4: Cài đặt môi trường Selenium với Java

✅ Cài đặt môi trường Maven trên Windows

🔆 Cách tải và cài biến môi trường Maven trên windows

Để tải Apache Maven trên máy tính chạy hệ điều hành windows, điều đầu tiên chúng ta cần làm là tải file maven zip từ trang chủ và giải nén ra. Sau đó chúng ta cần cài biến môi trường cho Maven để có thể sử dụng trên máy.

Điều kiện cần

Để cài đặt và sử dụng Maven, trước tiên chúng ta cần đảm bảo máy tính đã cài sẵn JDK và đã cấu hình biến môi trường JAVA_HOME.

🔆 Tải Apache Maven

Apache Maven được tải miễn phí, các bạn có thể vào trang chủ của Apache Maven để tải xuống file zip. Chọn cái Binary zip archive



Tại thời điểm này phiên bản 3.8.6 đang là phiên bản mới nhất của Maven. Sau khi tải xong, các bạn tiến hành giải nén và đặt nó trong thư mục bất kỳ, nhưng hãy đặt trong thư mục ít đụng tới vì nếu lở các bạn xoá thì Maven sẽ không hoạt động được nữa. Sau khi giải nén thư mục sẽ trông giống như thế này.



Bây giờ chúng ta move nó sang ổ đĩa C:\ cho an toàn vì cũng ít đụng đến. An suggest thôi nhé.

🔆 Cài đặt biến môi trường cho Maven

Bước cuối cùng để chúng ta có thể sử dụng Maven là cài biến môi trường cho nó bằng cách.

Vào thanh tìm kiếm của windows gõ View advanced system settings hoặc Variable nó sẽ ra như bên dưới:

Trong System Properties dialog, chọn vào Advanced và chọn Environment Variables…



Trong Environment variables dialog, vào phần System variables chọn New
Trong này chúng ta sẽ tạo biến môi trường MAVEN_HOME và trỏ đến thư mục mà chúng ta đã lưu trước đó. Y như JDK chúng ta từng làm.



Nó sẽ như thế này



Tiếp theo chúng ta sẽ trỏ cái biến MAVEN_HOME này vào biến Path của hệ thống



Sau khi nhấn Edit thì sẽ hiện form tiếp tục nhấn New



Chúng ta nhập giá trị như sau:  %MAVEN_HOME%\bin



Nghĩa là chúng ta chỉ định từ biến MAVEN_HOME trỏ đến thư mục bin của nó

Tiếp theo nhấn Ok Ok Ok là xong.

🔆 Kiểm tra phiên bản Maven đã cài đặt

Để kiểm tra quá trình cài đặt đã thành công hay chưa chúng ta cần mở CMD lên và chạy những lệnh sau:

mvn -version

Nó sẽ hiển thị Maven version chúng ta vừa cài và cùng phiên bản JDK đã cài trước đó. Vậy là xong !!

Nếu các bạn check nó chưa ra thì ghi lệnh này thử nó có ra đường dẫn đúng chưa:  echo %MAVEN_HOME%

Khi nó ra đường dẫn rồi mà chưa hiểu biến môi trường thì chúng ta cần restart máy lại 😁

✅ Tạo Maven project trên IntelliJ IDEA

Bước 1: Mở IntelliJ và chọn File > New > Project

Bước 2: Chọn tab New Project và nhập thông tin như mẫu




🔆 Các bạn chú ý:

• Số 4 chọn Maven
• Số 6, 7 nhập gì cũng được. Không biết nhập gì thì nhập theo mẫu. Những thông tin này sẽ nằm trong file pom.xml sau khi create project.

✅ Cài đặt thư viện Selenium vào Maven project trên IntelliJ IDEA

Để cài đặt thư viện Selenium vào Maven project thì các bạn sẽ cài nó vào file pom.xml

Thư viện sẽ được lấy tại đây:  https://mvnrepository.com/

Chúng ta cần cái gì thì search cái đó rồi copy bỏ vào file pom.xml và build lại maven project là xong.

🔆 Ví dụ cài Selenium









Khi dán vào pom.xml nhớ để trong cặp thẻ <dependencies> </dependencies>

Dán thư viện vào xong nhớ reload project lại bằng cách nhấn vào biểu tượng Reload hoặc right click > maven > reload project

🔆 Kiểm tra Selenium đã cài đặt vào maven project

Các bạn tạo 1 class bất kỳ ở package test (không tạo bên package main) và nhập từ khoá WebDriver. Nếu nó gợi ý hiển thị lên như hình là đã cài đặt được Selenium thành công.

✅ Chạy code auto với Selenium

Để chạy được code mở Browser lên thì các bạn cần cài đặt thêm thư viện WebDriverManager hỗ trợ các phiên bản của Browser

<!-- https://mvnrepository.com/artifact/io.github.bonigarcia/webdrivermanager -->
<dependency>
    <groupId>io.github.bonigarcia</groupId>
    <artifactId>webdrivermanager</artifactId>
    <version>5.3.0</version>
</dependency>

Và SLF4J hỗ trợ CDP cho WebDriverManager

<!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-simple -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-simple</artifactId>
    <version>1.7.36</version>
    <scope>test</scope>
</dependency>

Để 2 thư viện trên vào sau chổ Selenium nhé.

File pom.xml hiện tại như này:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>anhtester.com</groupId>
    <artifactId>SeleniumMaven</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>

        <!-- https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java -->
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-java</artifactId>
            <version>4.5.0</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/io.github.bonigarcia/webdrivermanager -->
        <dependency>
            <groupId>io.github.bonigarcia</groupId>
            <artifactId>webdrivermanager</artifactId>
            <version>5.3.0</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-simple -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
            <version>1.7.36</version>
            <scope>test</scope>
        </dependency>

    </dependencies>

</project>

Các bạn tạo 1 class ví dụ TestSelenium và dán đoạn code này vào:

import io.github.bonigarcia.wdm.WebDriverManager;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;

import java.time.Duration;

public class TestSelenium {

    public static void main(String[] args) {

        //Khởi tạo browser với Chrome
        WebDriver driver;
        WebDriverManager.chromedriver().setup();
        driver = new ChromeDriver();
        driver.manage().window().maximize();
        driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10));

        //Mở trang anhtester.com
        driver.get("https://anhtester.com/");

        //Click nút Login
        driver.findElement(By.xpath("//a[@id='btn-login']")).click();

        //Tắt browser
        driver.quit();
    }

}

Yeah ok. Còn về code auto test thì các buổi hôm sau An chỉ cho mọi người từng bước nhé 😋

✅ Cài đặt thư viện Selenium Webdriver vào Eclipse

Để viết được automation test với Selenium Webdriver, chúng ta cần những thứ sau:

• Java => tất nhiên rồi, mình đang chuẩn bị học Selenium Webdriver với Java mà hahaa. Các bạn có thể sử dụng Java 8 trở lên, riêng mình quen dùng Java 8 nên sẽ download Java 8. Để đạt được kết quả tốt, các bạn cần nắm được Java Core, không cần phải giỏi, nhưng OOP (hướng đối tượng) là thứ cần tìm hiểu.

• Công cụ hỗ trợ code, ở đây mình sẽ sử dụng Eclipse, các bạn có thể sử dụng bất cứ IDE nào khác như Intellij IDEA hoặc là Atom. Tuy nhiên mình dùng Eclipse vì nó căn bản cho người mới học. Nó miễn phí nữa. Nhưng về sau chúng ta sẽ dùng IntelliJ ngon hơn.

• Driver của browser: tức là mỗi loại browser, khi muốn chạy nó thì cần 1 loại driver tương ứng, đúng như tên gọi nó giống như là bác tài để vận hành nó. Ví dụ Chrome thì phải dùng chromedriver, Firefox thì dùng geckodriver. Trong các ví dụ mình chỉ dùng Chrome và chromedriver để demo. Vì nó có sẵn trong má, sau này khi các bạn muốn run các loại Browser khác hay multiBrowser, chỉ cần áp dụng đúng nguyên tắc là được.

• Tất nhiên mình cũng cần cài đặt Browser đó trong máy (máy mình có sẵn Chrome )

Link download sẽ được đặt ở cuối bài, còn hyperlink sẽ chèn trong bài viết

A. Cài đặt Chrome Browser

Đầu tiên, chúng ta cài đặt Chrome browser ở trang chủ
Có khi máy các bạn đã có sẵn ấy chứ. Một lưu ý cực kì quan trọng là sau bước này, các bạn phải tiến hành check version của Chrome để tải chromedriver cho đúng, nếu không sẽ phát sinh lỗi khi run script. Gõ vào chrome://settings/help để tiến hành kiểm tra Chrome version.

B. Download Chrome Driver

Cuối cùng là tải về Chrome Driver (chromedriver.exe), click vào đây

Hoặc https://sites.google.com/chromium.org/driver/downloads

Các bạn phải tải về đúng với version của Chrome hoặc lớn hơn mà mình đang dùng nhé

Sau khi tải về, các bạn giải nén ra, sẽ ra một  tập tin tên là chromedriver.exe (trên Window), còn trên MAC là chromedriver

C. Bước cuối cùng - tạo một project và add Selenium Webdriver vào

Trước hết, chúng ta hãy tải Selenium Webdriver về máy đã
Đây là link tải về : Tài nguyên cài đặt
(Hiện tại chúng ta dùng bản 3.141.59 là bản v3 ổn nhất của Selenium WebDriver)

Đây là 1 file có đuôi là *.jar, hãy nhớ đường dẫn của nó

Sau đó chúng ta mở Eclipse lên, tạo một project mới 

Đặt tên cho Project đó, nhớ chọn JDK đúng với Version Java của mình 

Sau khi tạo Project Java xong, tới một bước quan trọng là bỏ library của Selenium Webdriver vào Project, để nó có thể chạy được các command của Webdriver

Ấn chuột phải vào Project, sau đó chọn Properties

Chọn Java Build Path => Libraries => click chọn Classpath  => Add External Jar => Browser tới cái file jar đã download bên trên



Nếu ra kết quả, xuất hiện một Referenced Library giống hình, là ta đã thành công
 


Hoàn tất quá trình Add thư viện Selenium vào Eclipse.

2. Chạy code Auto đầu tiên

Nào bắt đầu thôi, trước tiên hãy tạo một class mới, bằng cách click chuột phải vào src, sau đó chọn New = > Class

Cấu trúc thư mục hiển thị trên phần Explorer của Eclipse (IDE) giống như trong Window vậy, đồng cấp tức là chung thư mục, ở đây src là cha, thì nếu ta tạo 1 Class tên là FirstDemo, SecondDemo thì 2 class này nằm trong thư mục src. Ở đây src được gọi là source folder. Cấu trúc và cách phân lớp nó mình sẽ nói sau, tạm thời ta cứ tạo một Class tên là FirstDemo nằm trong src để chạy thử trước nhé

Lúc tạo Class các bạn tạo luôn 1 package tên là test - như hình, package chính là thư mục chứa file Class FirstDemo của chúng ta

Sau khi tạo xong class, IDE sẽ auto generate cho chúng ta một đoạn script có dạng như sau

package test;

public class FirstDemo {

	public static void main(String[] args) {
		// TODO Auto-generated method stub

	}

}

Tiếp đến , Selenium WebDriver sẽ cần biết đâu là tệp thực thi mà bạn có, bởi vì, như đã nói ở bài trước, chúng ta cần chromedriver.exe để chạy Chrome browser, tương tự với geckodriver.exe cho Firefox browser.

Chúng ta thực hiện việc này bằng cách sử dụng lệnh: System.setProperty()

Đây là keyword cần phải nhớ "webdriver.chrome.driver"

Trong khi c:\\chromedriver.exe là đường dẫn chứa file chromedriver.exe mà chúng ta đã tải về ở bài trước 

System.setProperty("webdriver.chrome.driver", "c:\\chromedriver.exe");

Sau đó lại khởi tạo biến instance cho driver là "driver"  (các bạn đặt tên tùy ý)

WebDriver driver = new ChromeDriver();

Để giải quyết vấn đề này, chúng ta có một số cách như sau:
1. Nhấn Ctrl + Shift + O để IDE import thư viện vào
2. Click chuột trái vào chỗ mình đánh dấu trên hình, chọn import WebDriver, sau đó vẫn còn lại lỗi tương tự thì ta lặp lại thao tác để import nốt ChromeDriver là xong. Cách này hơi lằng nhằng vì phải ấn chuột mấy lần, vẫn dùng Ctrl + Shift + O cho nhanh. Tuy nhiên nó vẫn có ưu điểm của nó, đến phần cài đặt TestNG mình sẽ giải thích

Sau khi import, đây là đoạn script:

package test;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;

public class FirstDemo {

	public static void main(String[] args) {
		// TODO Auto-generated method stub
		
	    System.setProperty("webdriver.chrome.driver", "c:\\chromedriver.exe");
	 
	    WebDriver driver = new ChromeDriver();


	}

}

Sau khi đã hoàn tất hết, chúng ta dùng phương thức get(); để đi đến site https://anhtester.com

driver.navigate().to("https://anhtester.com");

Phương thức get(); nhận tham số là một chuỗi URL nhé. Mình sẽ hướng dẫn các bạn đọc Document của Selenium để biết cách dùng các phương thức (hàm) của nó. Để sau này có thể tự đọc các Framework khác.

Mở một trang web chỉ gói gọn trong 1 dòng đó thôi. Tại đây các bạn có thể nhấn Ctrl + F11 để run thử, nếu browser được mở lên và đi đến https://anhtester.com, có nghĩa là bạn đã làm đúng.

Mình sử dụng một loạt các phương thức khác, để thực thi kịch bản ghi ở trên:

        //1 - Maximize browser của mình
        driver.manage().window().maximize();

        //2 - Đi đến 1 url
        
        driver.navigate().to("https://anhtester.com");

        //3 - Lấy Title và in ra console
        
        System.out.println(driver.getTitle());

        // Thoát hẳn Browser

        driver.quit();

Như vậy chúng ta đã có một class hoàn chỉnh sau khi ghép đầy đủ các đoạn script trên với nhau, ấn Ctrl + F11 hoặc click vào nút Run trên IDE để chạy Selenium nào.



Quan sát và chờ kết quả, Browser sẽ thực thi y hệt như những gì chúng ta nói trên, bên phải Console đã in ra Title của Page Anh Tester, chúng ta đã thành công... Wohoooo



An build thêm cái website này hỗ trợ các bạn chạy auto test trên này: