racejar 1.0.3 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.1.0](https://github.com/portabletext/editor/compare/racejar-v1.0.3...racejar-v1.1.0) (2024-12-02)
+
+
+### Features
+
+* **`compileFeature`:** allow passing context to each `step` ([05d6a23](https://github.com/portabletext/editor/commit/05d6a233d18eada7a46ff52520155f22d58f6ae4))
+* add initial version of `racejar/playwright` ([2cac384](https://github.com/portabletext/editor/commit/2cac3846db0f01a157c00d55b0b7ba802278fe0a))
+
 ## [1.0.3](https://github.com/portabletext/editor/compare/racejar-v1.0.2...racejar-v1.0.3) (2024-12-01)
 
 

package/example-playwright/playwright-homepage.test.ts

@@ -0,0 +1,35 @@
+import {expect} from '@playwright/test'
+import {Feature, type PlaywrightContext} from '../src/playwright'
+import {Given, Then, When} from '../src/step-definitions'
+
+type Context = PlaywrightContext
+
+Feature({
+  featureText: `
+    Feature: Playwright Homepage
+      Scenario: Navigating to Get Started
+        Given the homepage
+        When clicking the "Get started" link
+        Then the heading is "Installation"`,
+  stepDefinitions: [
+    Given('the homepage', async (context: Context) => {
+      await context.playwright.page.goto('https://playwright.dev/')
+    }),
+    When(
+      'clicking the {string} link',
+      async (context: Context, linkName: string) => {
+        await context.playwright.page
+          .getByRole('link', {name: linkName})
+          .click()
+      },
+    ),
+    Then(
+      'the heading is {string}',
+      async (context: Context, heading: string) => {
+        await expect(
+          context.playwright.page.getByRole('heading', {name: heading}),
+        ).toBeVisible()
+      },
+    ),
+  ],
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "racejar",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "A testing framework agnostic Gherkin driver",
   "keywords": [
     "cucumber",
@@ -30,6 +30,10 @@
       "default": "./src/jest/index.ts",
       "types": "./src/jest/index.ts"
     },
+    "./playwright": {
+      "default": "./src/playwright/index.ts",
+      "types": "./src/playwright/index.ts"
+    },
     "./vitest": {
       "default": "./src/vitest/index.ts",
       "types": "./src/vitest/index.ts"
@@ -40,12 +44,14 @@
     "@cucumber/gherkin": "^30.0.4",
     "@cucumber/messages": "^27.0.2",
     "@jest/globals": "^29.7.0",
+    "@playwright/test": "^1.49.0",
     "@sanity/pkg-utils": "^6.11.13",
     "typescript": "5.7.2",
     "vitest": "^2.1.5"
   },
   "peerDependencies": {
     "@jest/globals": "^29.7.0",
+    "@playwright/test": "^1.49.0",
     "vitest": "^2.1.5"
   },
   "scripts": {

package/src/compile-feature.ts

@@ -10,20 +10,24 @@ import type {StepDefinition} from './step-definitions'
 /**
  * @public
  */
-export type CompiledFeature = {
-  name: string
-  tag?: 'only' | 'skip'
-  scenarios: Array<{
+export type CompiledFeature<TStepContext extends Record<string, any> = object> =
+  {
     name: string
     tag?: 'only' | 'skip'
-    steps: Array<() => Promise<void> | void>
-  }>
-}
+    scenarios: Array<{
+      name: string
+      tag?: 'only' | 'skip'
+      steps: Array<(stepContext?: TStepContext) => Promise<void> | void>
+    }>
+  }
 
 /**
  * @public
  */
-export function compileFeature<TContext extends Record<string, any> = object>({
+export function compileFeature<
+  TContext extends Record<string, any> = object,
+  TStepContext extends Record<string, any> = object,
+>({
   featureText,
   stepDefinitions,
   parameterTypes,
@@ -31,7 +35,7 @@ export function compileFeature<TContext extends Record<string, any> = object>({
   featureText: string
   stepDefinitions: Array<StepDefinition<TContext, any, any, any>>
   parameterTypes?: Array<ParameterType<unknown>>
-}): CompiledFeature {
+}): CompiledFeature<TStepContext> {
   const uuidFn = Messages.IdGenerator.uuid()
   const builder = new Gherkin.AstBuilder(uuidFn)
   const matcher = new Gherkin.GherkinClassicTokenMatcher()
@@ -115,7 +119,13 @@ export function compileFeature<TContext extends Record<string, any> = object>({
 
       const args = matchingStep.args.map((arg) => arg.getValue(matchingStep))
 
-      return () => matchingStep.callback(context, args[0], args[1], args[2])
+      return (stepContext: TStepContext | undefined) =>
+        matchingStep.callback(
+          Object.assign(context, stepContext),
+          args[0],
+          args[1],
+          args[2],
+        )
     })
 
     return {

package/src/playwright/index.ts

@@ -0,0 +1 @@
+export * from './playwright-gherkin-driver'

package/src/playwright/playwright-gherkin-driver.ts

@@ -0,0 +1,64 @@
+import type {ParameterType} from '@cucumber/cucumber-expressions'
+import {test, type BrowserContext, type Page} from '@playwright/test'
+import {compileFeature} from '../compile-feature'
+import type {StepDefinition} from '../step-definitions'
+
+/**
+ * @public
+ */
+export type PlaywrightContext = {
+  playwright: {
+    page: Page
+    context: BrowserContext
+  }
+}
+
+/**
+ * @public
+ */
+export function Feature<
+  TContext extends PlaywrightContext = PlaywrightContext,
+>({
+  featureText,
+  stepDefinitions,
+  parameterTypes,
+}: {
+  featureText: string
+  stepDefinitions: Array<StepDefinition<TContext, any, any, any>>
+  parameterTypes?: Array<ParameterType<unknown>>
+}) {
+  const feature = compileFeature({
+    featureText,
+    stepDefinitions,
+    parameterTypes,
+  })
+
+  const describeFn =
+    feature.tag === 'only'
+      ? test.describe.only
+      : feature.tag === 'skip'
+        ? test.describe.skip
+        : test.describe
+
+  describeFn(feature.name, async () => {
+    for (const scenario of feature.scenarios) {
+      const testFn =
+        scenario.tag === 'only'
+          ? test.only
+          : scenario.tag === 'skip'
+            ? test.skip
+            : test
+
+      testFn(scenario.name, async ({page, context}) => {
+        for (const step of scenario.steps) {
+          await step({
+            playwright: {
+              page,
+              context,
+            },
+          })
+        }
+      })
+    }
+  })
+}

package/vitest.workspace.ts

@@ -6,12 +6,14 @@ export default defineWorkspace([
     plugins: [],
     test: {
       name: 'unit',
+      exclude: ['example-playwright'],
     },
   },
   {
     plugins: [],
     test: {
       name: 'chromium',
+      exclude: ['example-playwright'],
     },
   },
 ])