@qavajs/playwright-runner-adapter 2.3.3 → 2.5.0

package/adapter/gherkin.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectPositions = collectPositions;
+exports.resolveLocation = resolveLocation;
+exports.callAt = callAt;
+exports.stepTitle = stepTitle;
+exports.toPickleArgument = toPickleArgument;
+exports.buildSnippet = buildSnippet;
+exports.formatLocation = formatLocation;
+exports.featureTitle = featureTitle;
+const node_vm_1 = require("node:vm");
+const cucumber_1 = require("@cucumber/cucumber");
+const PREVIEW_LENGTH = 50;
+/**
+ * Map ast node ids (scenarios, steps, example rows, rules) of a gherkin document to their positions
+ */
+function collectPositions(gherkinDocument) {
+    const positions = new Map();
+    const addSteps = (steps) => {
+        for (const step of steps)
+            positions.set(step.id, step.location);
+    };
+    const addScenario = (scenario) => {
+        positions.set(scenario.id, scenario.location);
+        addSteps(scenario.steps);
+        for (const examples of scenario.examples) {
+            for (const row of examples.tableBody)
+                positions.set(row.id, row.location);
+        }
+    };
+    for (const child of gherkinDocument.feature?.children ?? []) {
+        if (child.background)
+            addSteps(child.background.steps);
+        if (child.scenario)
+            addScenario(child.scenario);
+        if (child.rule) {
+            for (const ruleChild of child.rule.children) {
+                if (ruleChild.background)
+                    addSteps(ruleChild.background.steps);
+                if (ruleChild.scenario)
+                    addScenario(ruleChild.scenario);
+            }
+        }
+    }
+    return positions;
+}
+/**
+ * Resolve location of a pickle or pickle step.
+ * The last ast node id is used, so scenario outline examples point to their example row.
+ */
+function resolveLocation(positions, file, astNodeIds) {
+    for (let i = astNodeIds.length - 1; i >= 0; i--) {
+        const position = positions.get(astNodeIds[i]);
+        if (position)
+            return { file, line: position.line, column: position.column ?? 1 };
+    }
+    return undefined;
+}
+/**
+ * Call function so that the immediate caller frame reports the given source location.
+ * Playwright takes test and describe locations from the caller frame,
+ * so this makes reports, `--list` and IDE integrations point to the feature file instead of the adapter.
+ */
+function callAt(location, fn, args) {
+    if (!location)
+        return fn(...args);
+    const code = '(function (fn, args) { return fn(...args); })';
+    const callColumn = code.indexOf('fn(...args)');
+    const caller = (0, node_vm_1.runInThisContext)(code, {
+        filename: location.file,
+        lineOffset: location.line - 1,
+        columnOffset: location.column - 1 - callColumn
+    });
+    return caller(fn, args);
+}
+function preview(text) {
+    const singleLine = text.replace(/\s*\n\s*/g, ' ↵ ').replace(/\s+/g, ' ').trim();
+    return singleLine.length > PREVIEW_LENGTH
+        ? `${singleLine.slice(0, PREVIEW_LENGTH - 1)}…`
+        : singleLine;
+}
+/**
+ * Build step title for reports including short preview of doc string or data table argument
+ */
+function stepTitle(pickleStep) {
+    const argument = pickleStep.argument;
+    if (argument?.docString) {
+        return `${pickleStep.text} [MultiLine: ${preview(argument.docString.content)}]`;
+    }
+    if (argument?.dataTable) {
+        const rows = argument.dataTable.rows
+            .map(row => `| ${row.cells.map(cell => cell.value).join(' | ')} |`)
+            .join(' ');
+        return `${pickleStep.text} [DataTable: ${preview(rows)}]`;
+    }
+    return pickleStep.text;
+}
+function isTable(value) {
+    return Array.isArray(value) && value.every(row => Array.isArray(row));
+}
+/**
+ * Convert value passed to executeStep into a pickle step argument.
+ * Strings become doc strings, `string[][]` and DataTable instances become data tables.
+ */
+function toPickleArgument(value) {
+    if (typeof value === 'string') {
+        return { argument: { docString: { content: value } } };
+    }
+    const rows = value instanceof cucumber_1.DataTable ? value.raw() : isTable(value) ? value : undefined;
+    if (rows) {
+        return {
+            argument: {
+                dataTable: {
+                    rows: rows.map(row => ({ cells: row.map(cell => ({ value: String(cell) })) }))
+                }
+            }
+        };
+    }
+    return { extra: value };
+}
+const KEYWORD_TYPES = {
+    Context: 'precondition',
+    Action: 'event',
+    Outcome: 'outcome'
+};
+/**
+ * Build cucumber-style snippet for undefined step
+ */
+function buildSnippet(supportCodeLibrary, pickleStep) {
+    try {
+        const { default: SnippetBuilder } = require('@cucumber/cucumber/lib/formatter/step_definition_snippet_builder/index');
+        const { default: SnippetSyntax } = require('@cucumber/cucumber/lib/formatter/step_definition_snippet_builder/javascript_snippet_syntax');
+        const builder = new SnippetBuilder({
+            snippetSyntax: new SnippetSyntax('async-await'),
+            parameterTypeRegistry: supportCodeLibrary.parameterTypeRegistry
+        });
+        return builder.build({
+            keywordType: KEYWORD_TYPES[pickleStep.type ?? ''] ?? 'precondition',
+            pickleStep
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+function formatLocation(location) {
+    return location ? `${location.file}:${location.line}` : '';
+}
+/**
+ * Feature title used for describe block; falls back to file path for unnamed features
+ */
+function featureTitle(name, uri) {
+    return name?.trim() ? name : uri;
+}
+//# sourceMappingURL=gherkin.js.map

package/adapter/gherkin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gherkin.js","sourceRoot":"","sources":["../src/gherkin.ts"],"names":[],"mappings":"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"}

package/adapter/index.d.ts

@@ -3,3 +3,5 @@ export * from './filter';
 export * from './Template';
 export * from '@cucumber/cucumber';
 export * from './cucumberAdapter';
+export * from './testDetails';
+export * from './withWorld';

package/adapter/index.js

@@ -19,4 +19,6 @@ __exportStar(require("./filter"), exports);
 __exportStar(require("./Template"), exports);
 __exportStar(require("@cucumber/cucumber"), exports);
 __exportStar(require("./cucumberAdapter"), exports);
+__exportStar(require("./testDetails"), exports);
+__exportStar(require("./withWorld"), exports);
 //# sourceMappingURL=index.js.map

package/adapter/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2CAAyB;AACzB,6CAA2B;AAC3B,qDAAmC;AACnC,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2CAAyB;AACzB,6CAA2B;AAC3B,qDAAmC;AACnC,oDAAkC;AAAA,gDAA8B;AAChE,8CAA4B"}

package/adapter/js/PlaywrightWorld.d.ts

@@ -1,18 +1,20 @@
 import { APIRequestContext, Browser, BrowserContext, Page } from '@playwright/test';
-import type { CucumberAdapterConfig, SupportCodeLibrary, WorldOptions } from './types';
+import type { AttachFn, CucumberAdapterConfig, SupportCodeLibrary, WorldOptions } from './types';
 export declare class TestWorld {
     log: (data: unknown) => void;
-    attach: (data: unknown, details?: {
-        fileName?: string;
-        mediaType?: string;
-    }) => Promise<void>;
+    attach: AttachFn;
     parameters: unknown;
     config: CucumberAdapterConfig;
     supportCodeLibrary: SupportCodeLibrary;
     test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
     expect: import("@playwright/test").Expect<{}>;
     constructor(options: WorldOptions);
-    executeStep(this: TestWorld, text: string, extraParam?: unknown): Promise<void>;
+    /**
+     * Execute step by its text
+     * @param text - step text
+     * @param argument - doc string (`string`), data table (`string[][]` or `DataTable`) or any extra parameter
+     */
+    executeStep(this: TestWorld, text: string, argument?: unknown): Promise<void>;
 }
 export declare class PlaywrightWorld extends TestWorld {
     page: Page;

package/adapter/js/PlaywrightWorld.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlaywrightWorld = exports.TestWorld = void 0;
 const test_1 = require("@playwright/test");
+const gherkin_1 = require("./gherkin");
+const timeout_1 = require("./timeout");
 class TestWorld {
     log;
     attach;
@@ -17,7 +19,12 @@ class TestWorld {
         this.supportCodeLibrary = options.supportCodeLibrary;
         this.config = options.config;
     }
-    async executeStep(text, extraParam) {
+    /**
+     * Execute step by its text
+     * @param text - step text
+     * @param argument - doc string (`string`), data table (`string[][]` or `DataTable`) or any extra parameter
+     */
+    async executeStep(text, argument) {
         const steps = this.supportCodeLibrary.stepDefinitions
             .filter(s => s.matchesStepName(text));
         if (steps.length === 0)
@@ -27,13 +34,19 @@ class TestWorld {
             throw new Error(`Step "${text}" matches multiple step definitions:\n${locations}`);
         }
         const step = steps[0];
-        const { parameters } = await step.getInvocationParameters({ step: { text }, world: this });
-        try {
-            await step.code.apply(this, [...parameters, extraParam]);
-        }
-        catch (err) {
-            throw new Error(`Step failed: ${text}`, { cause: err });
-        }
+        const { argument: pickleArgument, extra } = (0, gherkin_1.toPickleArgument)(argument);
+        const location = step.uri ? { file: step.uri, line: step.line, column: 1 } : undefined;
+        // reported as a nested step, so failures inside composite steps point to the exact inner step
+        await this.test.step((0, gherkin_1.stepTitle)({ text, argument: pickleArgument }), async () => {
+            const { parameters } = await step.getInvocationParameters({ step: { text, argument: pickleArgument }, world: this });
+            const args = extra === undefined ? parameters : [...parameters, extra];
+            try {
+                await (0, timeout_1.runWithTimeout)(() => step.code.apply(this, args), (0, timeout_1.resolveTimeout)(step, this.supportCodeLibrary.defaultTimeout), `Step '${text}' timed out after {timeout} ms\n  at ${step.uri}:${step.line}`);
+            }
+            catch (err) {
+                throw new Error(`Step failed: ${text}`, { cause: err });
+            }
+        }, { location });
     }
 }
 exports.TestWorld = TestWorld;

package/adapter/js/Template.d.ts

@@ -1,10 +1,21 @@
+export interface TemplateStep {
+    text: string;
+    argument?: string | string[][];
+}
+/**
+ * Parse template text into steps. Supports data tables (`| a | b |` lines)
+ * and doc strings (`"""` or ``` blocks) placed after a step.
+ */
+export declare function parseTemplate(scenario: string): TemplateStep[];
 /**
  * Define template step
- * @param {string} scenario - multiline string with steps
+ * @param {string} scenario - multiline string with steps; steps can have data tables and doc strings
  * @example
  * When('I click {string} and verify {string}', Template((locator, expected) => `
  *     I click '${locator}'
  *     I expect '${locator} > Value' to equal '${expected}'
+ *     I fill form
+ *       | name | John |
  * `));
  */
-export declare function Template(scenario: (...args: unknown[]) => string): (...args: unknown[]) => string;
+export declare function Template(scenario: (...args: any[]) => string): (...args: unknown[]) => string;

package/adapter/js/Template.js

@@ -1,25 +1,74 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTemplate = parseTemplate;
 exports.Template = Template;
+const DOC_STRING_DELIMITERS = ['"""', '```'];
+function parseRow(line) {
+    const content = line.replace(/^\|/, '').replace(/(?<!\\)\|$/, '');
+    return content
+        .split(/(?<!\\)\|/)
+        .map(cell => cell.trim().replace(/\\\|/g, '|'));
+}
+function stripIndent(line, indent) {
+    const leading = line.length - line.trimStart().length;
+    return line.slice(Math.min(indent, leading));
+}
+/**
+ * Parse template text into steps. Supports data tables (`| a | b |` lines)
+ * and doc strings (`"""` or ``` blocks) placed after a step.
+ */
+function parseTemplate(scenario) {
+    const lines = scenario.split('\n');
+    const steps = [];
+    const previousStep = (line) => {
+        const step = steps.at(-1);
+        if (!step)
+            throw new Error(`Template argument "${line.trim()}" must follow a step`);
+        return step;
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const delimiter = DOC_STRING_DELIMITERS.find(d => trimmed.startsWith(d));
+        if (delimiter) {
+            const step = previousStep(line);
+            const indent = line.indexOf(delimiter);
+            const content = [];
+            for (i++; i < lines.length && lines[i].trim() !== delimiter; i++) {
+                content.push(stripIndent(lines[i], indent));
+            }
+            step.argument = content.join('\n');
+            continue;
+        }
+        if (trimmed.startsWith('|')) {
+            const step = previousStep(line);
+            if (!Array.isArray(step.argument))
+                step.argument = [];
+            step.argument.push(parseRow(trimmed));
+            continue;
+        }
+        steps.push({ text: trimmed });
+    }
+    return steps;
+}
 /**
  * Define template step
- * @param {string} scenario - multiline string with steps
+ * @param {string} scenario - multiline string with steps; steps can have data tables and doc strings
  * @example
  * When('I click {string} and verify {string}', Template((locator, expected) => `
  *     I click '${locator}'
  *     I expect '${locator} > Value' to equal '${expected}'
+ *     I fill form
+ *       | name | John |
  * `));
  */
 function Template(scenario) {
     return new Proxy(scenario, {
         apply: async function (template, world, args) {
-            const scenario = template(...args);
-            const steps = scenario
-                .split('\n')
-                .map(step => step.trim())
-                .filter(Boolean);
-            for (const step of steps) {
-                await world.executeStep(step);
+            for (const step of parseTemplate(template(...args))) {
+                await world.executeStep(step.text, step.argument);
             }
         },
     });

package/adapter/js/cucumberAdapter.d.ts

@@ -1,2 +1,9 @@
+import type { Pickle } from '@cucumber/messages';
 import type { CucumberAdapterConfig } from './types';
+/**
+ * Create scenario filter from tag expressions keyed by their source (used in error messages),
+ * e.g. `{ 'tags option': config.tags, 'CUCUMBER_TAGS env variable': process.env.CUCUMBER_TAGS }`.
+ * All expressions must match.
+ */
+export declare function createTagFilter(sources: Record<string, string | undefined>): (pickle: Pickle) => boolean;
 export declare function defineConfig(config: CucumberAdapterConfig): void;