playwright-cucumber-ts-steps 1.1.2 → 1.1.3

package/README.md

@@ -95,30 +95,39 @@ Feature: User Authentication
 ### 4. Run Tests
 
 ```bash
-npx playwright test demo.spec.ts --headed
+npx playwright test
 ```
 
 ---
 
-## 🏷️ Tags & Filtering
+## 🏷️ Tag Filtering (New!)
 
-You can use tags to organize your tests and run specific subsets (e.g., only Smoke tests).
+We support a **Friendly Syntax** for filtering tests via the `TAGS` environment variable.
 
-**In your Feature file:**
+| Logic   | Symbol  | Example          | Description                                           |
+| ------- | ------- | ---------------- | ----------------------------------------------------- |
+| **OR**  | `,`     | `@login,@signup` | Run tests that have `@login` **OR** `@signup`.        |
+| **AND** | `+`     | `@smoke+@api`    | Run tests that have **BOTH** `@smoke` **AND** `@api`. |
+| **MIX** | `,` `+` | `@a+@b, @c`      | Run tests with (`@a` AND `@b`) **OR** just `@c`.      |
 
-```gherkin
-Feature: Checkout
+**Usage:**
+
+```bash
+# Run only smoke tests
+TAGS='@smoke' npx playwright test
 
-  @smoke @critical
-  Scenario: Guest Checkout
-    ...
+# Run smoke tests that are also critical
+TAGS='@smoke+@critical' npx playwright test
 
-  @regression
-  Scenario: Registered User Checkout
-    ...
+# Run login OR regression tests
+TAGS='@login,@regression' npx playwright test
 
 ```
 
+_(On Windows PowerShell, use `$env:TAGS="@smoke"; npx playwright test`)_
+
+````
+
 **In your Test Runner (`tests/bdd.spec.ts`):**
 
 ```typescript
@@ -129,7 +138,7 @@ import { runTests } from "playwright-cucumber-ts-steps";
 
 // OPTION 2: Run only Smoke tests
 runTests("features/*.feature", { tags: "@smoke" });
-```
+````
 
 ---
 

package/dist/core/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAOA,OAAO,0BAA0B,CAAC;AAClC,OAAO,6BAA6B,CAAC;AACrC,OAAO,2BAA2B,CAAC;AACnC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,uBAAuB,CAAC;AAE/B,OAAO,qBAAqB,CAAC;AAE7B,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC3C;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,QA2GpE"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAOA,OAAO,0BAA0B,CAAC;AAClC,OAAO,6BAA6B,CAAC;AACrC,OAAO,2BAA2B,CAAC;AACnC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,uBAAuB,CAAC;AAE/B,OAAO,qBAAqB,CAAC;AAE7B,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC3C;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,QAqHpE"}

package/dist/core/runner.js

@@ -52,9 +52,10 @@ function runTests(featureGlob, options) {
         state_1.dbState.setAdapter(options.dbQuery);
     }
     const files = (0, glob_1.globSync)(featureGlob);
-    // SUPPORT ENV VAR TAGS (Alternative to -g)
-    // If user runs: TAGS='@login' npx playwright test
     const envTag = process.env.TAGS;
+    if (files.length === 0) {
+        console.warn(`⚠️ No feature files found for pattern: ${featureGlob}`);
+    }
     for (const file of files) {
         const content = fs.readFileSync(file, "utf8");
         const featureMatch = content.match(/Feature:\s*(.+)/);
@@ -67,20 +68,25 @@ function runTests(featureGlob, options) {
             while ((match = scenarioRegex.exec(content)) !== null) {
                 const foundTags = match[1] || "";
                 const scenarioName = match[2].trim();
-                // 🔥 1. APPEND TAGS TO TITLE
-                // This allows 'npx playwright test -g @login' to work natively
+                // 1. APPEND TAGS TO TITLE (Keeps -g working if needed)
                 const fullName = foundTags
                     ? `${scenarioName} ${foundTags}`
                     : scenarioName;
-                // 🔥 2. FILTER LOGIC
-                // Filter by Code Options OR Env Variable
+                // 2. 🔥 FRIENDLY TAG FILTERING 🔥
                 const activeFilter = options?.tags || envTag;
                 if (activeFilter) {
-                    // Allow comma separated tags (OR logic): "@login,@regression"
-                    const targetTags = activeFilter.split(",").map((t) => t.trim());
-                    const hasMatch = targetTags.some((t) => foundTags.includes(t));
-                    if (!hasMatch)
-                        continue;
+                    // Logic:
+                    // ',' = OR  (e.g., "@login, @smoke")
+                    // '+' = AND (e.g., "@login+@smoke")
+                    const orGroups = activeFilter.split(","); // Split into OR groups
+                    const isMatch = orGroups.some((group) => {
+                        // For each group, check if ALL tags (joined by +) are present
+                        const andTags = group.split("+").map((t) => t.trim());
+                        return andTags.every((t) => foundTags.includes(t));
+                    });
+                    if (!isMatch) {
+                        continue; // Skip if no groups matched
+                    }
                 }
                 const startIndex = match.index + match[0].length;
                 const nextMatchIndex = content.slice(startIndex).search(/Scenario:/);
@@ -98,7 +104,6 @@ function runTests(featureGlob, options) {
                             stepText.startsWith("@") ||
                             stepText === "")
                             continue;
-                        // Handle Data Tables
                         const tableData = [];
                         while (i + 1 < lines.length && lines[i + 1].startsWith("|")) {
                             i++;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "playwright-cucumber-ts-steps",
   "description": "A collection of reusable Playwright step definitions for Cucumber in TypeScript, designed to streamline end-to-end testing across web, API, and mobile applications.",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "private": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",