playwright-cucumber-ts-steps 1.1.2 → 1.1.4

package/README.md

@@ -95,30 +95,43 @@ 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
+npx playwright test -g "@smoke"
+
+# Run smoke tests that are also critical
+TAGS='@smoke+@critical' npx playwright test
+npx playwright test -g "(?=.*@smoke)(?=.*@critical)"
 
-  @smoke @critical
-  Scenario: Guest Checkout
-    ...
+# Run login OR regression tests
+TAGS='@login,@regression' npx playwright test
 
-  @regression
-  Scenario: Registered User Checkout
-    ...
+npx playwright test -g "@login|@regression"
 
 ```
 
+_(On Windows PowerShell, use `$env:TAGS="@smoke"; npx playwright test`)_
+
+````
+
 **In your Test Runner (`tests/bdd.spec.ts`):**
 
 ```typescript
@@ -129,7 +142,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,QAgHpE"}

package/dist/core/runner.js

@@ -52,8 +52,8 @@ 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
+    // SUPPORT ENV VAR TAGS
+    // Usage: TAGS='@smoke,@api' npx playwright test
     const envTag = process.env.TAGS;
     for (const file of files) {
         const content = fs.readFileSync(file, "utf8");
@@ -62,25 +62,27 @@ function runTests(featureGlob, options) {
             ? featureMatch[1].trim()
             : "Unnamed Feature";
         test_1.test.describe(featureName, () => {
+            // SAFER 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
-                // This allows 'npx playwright test -g @login' to work natively
+                // 1. APPEND TAGS TO TITLE (Crucial for -g flag)
                 const fullName = foundTags
                     ? `${scenarioName} ${foundTags}`
                     : scenarioName;
-                // 🔥 2. FILTER LOGIC
-                // Filter by Code Options OR Env Variable
+                // 2. FILTER LOGIC (Supports multiple tags)
                 const activeFilter = options?.tags || envTag;
                 if (activeFilter) {
-                    // Allow comma separated tags (OR logic): "@login,@regression"
+                    // Logic: If user passes "@smoke,@regression", we check if the scenario has EITHER
+                    // Split by comma, trim spaces
                     const targetTags = activeFilter.split(",").map((t) => t.trim());
-                    const hasMatch = targetTags.some((t) => foundTags.includes(t));
-                    if (!hasMatch)
-                        continue;
+                    // Check if at least one tag matches (OR Logic)
+                    const isMatch = targetTags.some((t) => foundTags.includes(t));
+                    if (!isMatch) {
+                        continue; // Skip this test if it doesn't have any of the requested tags
+                    }
                 }
                 const startIndex = match.index + match[0].length;
                 const nextMatchIndex = content.slice(startIndex).search(/Scenario:/);
@@ -98,7 +100,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.4",
   "private": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",