playwright-cucumber-ts-steps 1.1.1 → 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":"AAMA,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,QAmGpE"}
+{"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

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runTests = runTests;
+// src/core/runner.ts
 const test_1 = require("@playwright/test");
 const fs = __importStar(require("fs"));
 const glob_1 = require("glob");
@@ -51,6 +52,7 @@ function runTests(featureGlob, options) {
         state_1.dbState.setAdapter(options.dbQuery);
     }
     const files = (0, glob_1.globSync)(featureGlob);
+    const envTag = process.env.TAGS;
     if (files.length === 0) {
         console.warn(`⚠️ No feature files found for pattern: ${featureGlob}`);
     }
@@ -61,20 +63,36 @@ function runTests(featureGlob, options) {
             ? featureMatch[1].trim()
             : "Unnamed Feature";
         test_1.test.describe(featureName, () => {
-            // 1. SAFE SCENARIO REGEX
             const scenarioRegex = /(?:(@[^:\r\n]+)\s+)?Scenario:\s*(.+)/g;
             let match;
             while ((match = scenarioRegex.exec(content)) !== null) {
                 const foundTags = match[1] || "";
                 const scenarioName = match[2].trim();
+                // 1. APPEND TAGS TO TITLE (Keeps -g working if needed)
+                const fullName = foundTags
+                    ? `${scenarioName} ${foundTags}`
+                    : scenarioName;
+                // 2. 🔥 FRIENDLY TAG FILTERING 🔥
+                const activeFilter = options?.tags || envTag;
+                if (activeFilter) {
+                    // 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:/);
                 const blockEnd = nextMatchIndex === -1 ? content.length : startIndex + nextMatchIndex;
                 const scenarioBlock = content.slice(startIndex, blockEnd);
-                if (options?.tags && !foundTags.includes(options.tags)) {
-                    continue;
-                }
-                (0, test_1.test)(scenarioName, async ({ page }, testInfo) => {
+                (0, test_1.test)(fullName, async ({ page }, testInfo) => {
                     const lines = scenarioBlock
                         .trim()
                         .split("\n")
@@ -86,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++;
@@ -100,7 +117,6 @@ function runTests(featureGlob, options) {
                             .replace(/^(Given|When|Then|And|But)\s+/i, "")
                             .replace(/:$/, "")
                             .trim();
-                        // 2. SMART STEP MATCHING
                         const matchResult = findMatchingStep(cleanStep);
                         if (!matchResult) {
                             throw new Error(`❌ Undefined Step: "${cleanStep}"`);
@@ -109,7 +125,6 @@ function runTests(featureGlob, options) {
                             const args = [...matchResult.args];
                             if (tableData.length > 0)
                                 args.push(tableData);
-                            console.log(`✅ Executing: ${cleanStep}`);
                             await matchResult.fn(page, ...args);
                         }
                         catch (error) {
@@ -130,32 +145,24 @@ function runTests(featureGlob, options) {
         });
     }
 }
-// 3. ROBUST FINDER FUNCTION
 function findMatchingStep(text) {
     for (const step of registry_1.stepRegistry) {
-        // A. Handle RegExp (If you defined steps with Regex)
         if (step.expression instanceof RegExp) {
             const match = step.expression.exec(text);
-            if (match) {
+            if (match)
                 return { fn: step.fn, args: match.slice(1) };
-            }
         }
-        // B. Handle Cucumber Expressions (The Objects we saw in your logs)
-        // We check if it has a .match() method
         else if (typeof step.expression.match === "function") {
             const match = step.expression.match(text);
-            if (match) {
+            if (match)
                 return {
                     fn: step.fn,
                     args: match.map((arg) => arg.getValue(null)),
                 };
-            }
         }
-        // C. Handle Simple Strings
         else if (typeof step.expression === "string") {
-            if (step.expression === text) {
+            if (step.expression === text)
                 return { fn: step.fn, args: [] };
-            }
         }
     }
     return null;

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.1",
+  "version": "1.1.3",
   "private": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",