dave

"Look Dave, I can see you're really upset about this. I honestly think you ought to sit down calmly, take a stress pill, and think things over." — HAL 9000, 2001: A Space Odyssey

Named after astronaut Dave Bowman, the only one who could keep HAL in check. In the same spirit, dave keeps an eye on halOP — the WildFly management console — making sure it behaves as expected.

UI test suite for halOP, the WildFly management console. Built with Playwright and TypeScript.

dave automatically starts a WildFly server and halOP container, runs end-to-end tests against the management console, and tears everything down when finished.

Prerequisites

• Node.js 22+
• pnpm (corepack-enabled, see packageManager in package.json)
• Podman or Docker — runs WildFly and halOP containers (auto-detected)

Getting Started

# Install dependencies
pnpm install

# Install Playwright browsers
pnpm exec playwright install chromium firefox webkit

# Run all tests (headless)
pnpm test

Code Quality

Command	Description
pnpm lint	Run ESLint
pnpm lint:fix	Run ESLint with auto-fix
pnpm format	Format all files with Prettier
pnpm format:check	Check formatting without changing

ESLint is configured with TypeScript and Playwright-specific rules. Prettier handles all formatting. See eslint.config.js and .prettierrc for details.

Running Tests

Command	Description
pnpm test	Run all tests headless (all browsers)
pnpm test:headed	Run with a visible browser window
pnpm test:ui	Playwright interactive UI mode
pnpm test:debug	Debug mode with Playwright inspector
pnpm report	Open the last HTML test report
pnpm allure:generate	Generate Allure report from results
pnpm allure:serve	Serve Allure report with live reload
pnpm allure:open	Open a generated Allure report
pnpm test:smoke	Run only @smoke tests
pnpm test:dashboard	Run only @dashboard tests
pnpm test:navigation	Run only @navigation tests
pnpm test:model-browser	Run only @model-browser tests

Filter tests by pattern, file, or browser:

pnpm test -- --grep "dashboard"
pnpm test -- src/tests/smoke/app-loads.spec.ts
pnpm test -- --project=chromium
pnpm test -- --project=firefox
pnpm test -- --project=webkit

Test Groups

Tests are tagged by feature area using Playwright's tag API. Tags are defined as typed constants in src/tags.ts.

Tag	Group	Test Files
@smoke	Smoke tests	app-loads, dashboard, navigation
@dashboard	Dashboard feature	dashboard
@navigation	Navigation feature	navigation
@model-browser	Model browser feature	model-browser

Tests can belong to multiple groups. Combine groups with OR logic:

pnpm test -- --grep "@smoke|@model-browser"

Exclude a group:

pnpm test -- --grep-invert @smoke

Tags are displayed as badges in the HTML test report and can be used to filter results.

To add a new group, add a constant to src/tags.ts and apply it to test files via the tag option on test.describe().

Configuration

Environment variables can be set in a .env file (see .env.example):

Variable	Default	Description
WILDFLY_IMAGE	quay.io/wado/wado-sa:development	WildFly container image
HALOP_IMAGE	quay.io/halconsole/hal-op:test-suite	halOP container image
HALOP_PORT	9090	Host port mapped to the halOP container

How It Works

Test Lifecycle

global-setup.ts              starts halOP container
                              writes state to /tmp/dave-state.json
                              sets HALOP_URL env var

  test.beforeAll()            starts a WildFly container per test file
                              (via testcontainers)
  src/fixtures/test.fixture.ts  creates page objects per test
  src/tests/**/*.spec.ts        test execution
  test.afterAll()             stops the WildFly container

global-teardown.ts            stops halOP container, cleans state file

Spec files run in parallel across multiple workers (4 locally, 2 in CI). Tests within a spec file are sequential. Each test file gets its own isolated WildFly container per browser project via testcontainers. Tests run in Chromium, Firefox, and WebKit.

Page Object Model

Custom Playwright fixtures in src/fixtures/test.fixture.ts provide page objects to each test:

Fixture	Purpose
basePage	OUIA enablement, navigation with ?connect= parameter
dashboardPage	Dashboard heading assertions
navigationPage	Sidebar navigation (Dashboard, Deployments, Configuration, Runtime, etc.)

Tests import test and expect from ../fixtures/test.fixture instead of @playwright/test.

Element Identification

Tests use OUIA attributes for element selection, following PatternFly's testing conventions. The OUIA component IDs defined in halOP are collected and published as the @halconsole/ouia npm package, which dave consumes to reference UI elements by stable, well-known identifiers.

Project Structure

dave/
  global-setup.ts              # Start halOP before tests
  global-teardown.ts           # Stop halOP after tests
  playwright.config.ts         # Playwright configuration
  src/
    fixtures/
      test.fixture.ts          # Custom fixtures with page objects
      wildfly.fixture.ts       # WildFly container lifecycle per test file
    pages/
      base.page.ts             # Base page object
      dashboard.page.ts        # Dashboard page object
      model-browser.page.ts    # Model browser page object
      navigation.page.ts       # Navigation page object
    tags.ts                    # Tag constants for test grouping
    tests/
      smoke/                   # Smoke tests
        app-loads.spec.ts
        dashboard.spec.ts
        navigation.spec.ts
      model-browser/           # Model browser tests
        model-browser.spec.ts
    utils/
      configure-testcontainers.ts  # Testcontainers config
      container-runtime.ts         # Auto-detect Podman or Docker
      wildfly-container.ts         # WildFly container lifecycle

CI/CD

GitHub Actions runs lint and tests on every push to main and on pull requests:

• Lint — checks formatting (Prettier) and linting (ESLint)
• Test — installs Chromium, Firefox, and WebKit, runs the full Playwright suite, and uploads test results as artifacts

The latest test reports from main are published to GitHub Pages:

• Allure report — includes trend charts that track pass/fail rates across runs
• Playwright report — built-in Playwright HTML report

Dependency updates are managed by Dependabot, configured for weekly npm and GitHub Actions updates.

Related Projects

Project	Description
halOP	WildFly management console (the application under test)
WildFly	The application server managed by halOP
testcontainers	Container management for integration tests

Container Images

Image	Description
quay.io/halconsole/hal-op:test-suite	halOP image used by the test suite
quay.io/wado/wado-sa:development	WildFly image used for test containers