Example Application & Test Layout

cd bookshelf
npm start                                   # http://localhost:3000
PORT=4000 npm start                         # another port
BOOKSHELF_REVIEW_DELAY_MS=100 npm start     # faster review saves for tests

curl -s -X POST localhost:3000/api/test/reset
# {"books":24,"reviews":3}

curl -s -X POST localhost:3000/api/test/seed -H 'content-type: application/json' \
  -d '{"books":[{"title":"Only Book","author":"Test Author"}],"reviews":[]}'
# {"books":1,"reviews":0}

curl -s localhost:3000/api/books
# {"items":[{"id":1,"year":2020,"price":12.5,"genre":"Fiction", ... "title":"Only Book","author":"Test Author"}],"total":1,"page":1,"pageSize":6,"pages":1}

curl -s -X POST localhost:3000/api/reviews -b cookies.txt -H 'content-type: application/json' \
  -d '{"bookId":1,"rating":9,"text":"x"}'
# {"errors":{"rating":"Choose a rating from 1 to 5","text":"Write at least 10 characters"}}

// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  testDir: './tests',
  use: {
    baseURL: process.env.BASE_URL ?? 'http://localhost:3000',
    trace: 'on-first-retry',
    testIdAttribute: 'data-testid',
  },
  // Start Bookshelf unless BASE_URL points at a server that is already running.
  webServer: process.env.BASE_URL
    ? undefined
    : {
        command: 'node server.js',
        cwd: '../../bookshelf',
        url: 'http://localhost:3000',
        reuseExistingServer: true,
        env: { BOOKSHELF_REVIEW_DELAY_MS: '100' },
      },
  projects: [
    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
    { name: 'webkit', use: { ...devices['Desktop Safari'] } },
  ],
});

// cypress.config.ts
import { defineConfig } from 'cypress';

export default defineConfig({
  e2e: { baseUrl: 'http://localhost:3000', video: false, setupNodeEvents() {} },
  // Read in tests with cy.env(['READER_PASSWORD']); override with CYPRESS_READER_PASSWORD.
  env: { READER_PASSWORD: 'reader-local-only' },
});

// src/test/java/demo/ReviewPageObjectTest.java (excerpt)
static final String BASE_URL = System.getenv().getOrDefault("BASE_URL", "http://localhost:3000");
static final String READER_PASSWORD =
    System.getenv().getOrDefault("BOOKSHELF_READER_PASSWORD", "reader-local-only");

# tests/conftest.py (excerpt)
BASE_URL = os.environ.get("BASE_URL", "http://localhost:3000")
READER_PASSWORD = os.environ.get("BOOKSHELF_READER_PASSWORD", "reader-local-only")

playwright/
  package.json
  playwright.config.ts
  tests/
    fixtures.ts                  # extends test with page objects and a reset
    pages/
      book-details-page.ts
      sign-in-page.ts
    smoke.spec.ts
    review-page-object.spec.ts

cypress/
  package.json
  cypress.config.ts
  tsconfig.json
  cypress/
    e2e/
      smoke.cy.ts
      review-page-object.cy.ts
    support/
      e2e.ts                     # loaded before every spec
      commands.ts                # custom commands such as cy.signIn()
      pages/
        book-details-page.ts

selenium-java/
  pom.xml                        # selenium-java 4.51, JUnit Jupiter 5.14, surefire
  src/test/java/demo/
    pages/
      BookDetailsPage.java
      SignInPage.java
    SmokeTest.java
    ReviewPageObjectTest.java

selenium-python/
  .venv/                         # python >= 3.10 for Selenium 4.51
  tests/
    conftest.py                  # fixtures: driver, base_url, reset_data
    pages/
      __init__.py
      book_details_page.py
      sign_in_page.py
    test_smoke.py
    test_review_page_object.py