first commit

Author: aljazarifoundation

README.md

@@ -0,0 +1,117 @@
+# Playwright TypeScript BDD Automation
+
+This project automates end-to-end testing using **Playwright, TypeScript, and Cucumber (BDD framework)**.
+
+## 📌 Prerequisites
+
+Ensure you have the following installed:
+- **Node.js (LTS recommended)** → [Download](https://nodejs.org/)
+- **Playwright** → Installed via dependencies
+- **Cucumber.js** → Installed via dependencies
+
+## 🚀 Installation
+
+1. Clone the repository:
+   ```sh
+   git clone https://github.com/your-repo/PlaywrightTypeScriptUsingBDD.git
+   cd PlaywrightTypeScriptUsingBDD
+   ```
+2. Install dependencies:
+   ```sh
+   npm install
+   ```
+3. Install Playwright browsers:
+   ```sh
+   npx playwright install
+   ```
+
+## 📂 Project Structure
+
+```
+📂 PlaywrightTypeScriptUsingBDD
+ ┣ 📂 features/                # Cucumber feature files
+ ┣ 📂 steps/                   # Step definitions (Gherkin steps)
+ ┣ 📂 support/                 # Hooks and utility functions
+ ┣ 📂 reports/                 # Test reports (HTML & JSON)
+ ┣ 📜 package.json             # Dependencies & scripts
+ ┣ 📜 playwright.config.ts      # Playwright configuration
+ ┗ 📜 README.md                # Documentation
+```
+
+## 📝 Writing Tests
+
+### Example Feature File (`features/login.feature`)
+```gherkin
+Feature: Login to Sauce Demo
+  As a user
+  I want to be able to log in with valid and invalid credentials
+  So that I can access the inventory page or see an error message
+
+  @positive
+  Scenario Outline: Successful Login
+    Given I navigate to the Sauce Demo login page
+    When I enter username "<username>" and password "<password>"
+    And I click the login button
+    Then I should see the products page
+
+    Examples:
+      | username       | password      |
+      | standard_user | secret_sauce |
+
+  @negative
+  Scenario Outline: Invalid Login
+    Given I navigate to the Sauce Demo login page
+    When I enter username "<username>" and password "<password>"
+    And I click the login button
+    Then I should see an error message
+
+    Examples:
+      | username | password   |
+      | invalid  | wrong_pass |
+```
+
+## ▶️ Running Tests
+
+### Run All Scenarios
+```sh
+npx cucumber-js
+```
+
+### Run Only Positive Scenarios
+```sh
+npx cucumber-js --tags "@positive"
+```
+
+### Run Only Negative Scenarios
+```sh
+npx cucumber-js --tags "@negative"
+```
+
+### Run Tests in Headed Mode (Non-Headless)
+```sh
+HEADLESS=false npx cucumber-js
+```
+
+## 📊 Generating Reports
+
+### Generate Multiple Cucumber HTML Report
+```sh
+npm run report
+```
+
+### Generate Allure Report
+```sh
+npm run allure-report
+```
+
+## 🛠 Debugging
+
+If you encounter issues, try:
+```sh
+npx playwright test --debug
+```
+
+## 📜 License
+This project is licensed under the **MIT License**.
+
+# PlaywrightTypeScriptUsingBDD