a11y #2 port playwright tests to repo

Author: StephDriver

a11y/playwright/.gitignore

@@ -0,0 +1,8 @@
+
+# Playwright
+node_modules/
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/
+/playwright/.auth/

a11y/playwright/README.md

@@ -0,0 +1,71 @@
+# Playwright tests
+
+## Target size test
+
+The **target size** test (`tests/target_size.js`) opens a page, finds all focusable elements, measures their size, and writes a markdown report. Use it to check whether interactive controls meet [WCAG 2.2 target size](https://www.w3.org/WAI/WCAG22/Understanding/target-size.html) (Level AA: 24×24px minimum; Level AAA: 44×44px).
+
+### Prerequisites
+
+Install Playwright browsers once:
+
+```bash
+npx playwright install
+```
+
+### How to run
+
+From the `playwright` directory:
+
+```bash
+# Run with default URL (http://localhost:8000/olh/)
+npx playwright test target_size --project=chromium
+
+# Run against a specific URL
+TARGET_SIZE_URL=https://example.com npx playwright test target_size --project=chromium
+```
+
+To run in headed mode (see the browser):
+
+```bash
+npx playwright test target_size --project=chromium --headed
+```
+
+### What to expect
+
+- The test **passes** if it can load the page and collect focusable elements (even if none are found).
+- A markdown report is written and attached to the run:
+  - Path: `test-results/.../target-size-report.md` (exact path is printed in the test output).
+  - It is also attached in the HTML report; open it with `npx playwright show-report` after a run.
+
+The report includes:
+
+1. **Header** – URL, generation time, and total number of focusable elements.
+2. **Table** with one row per focusable element:
+
+   | Column | Meaning |
+   |--------|--------|
+   | # | Index |
+   | Tag | Element type (e.g. `a`, `button`, `input`) |
+   | Name / Label | Accessible name from `aria-label`, `title`, `placeholder`, or text (trimmed) |
+   | Width (px) | Rendered width in pixels |
+   | Height (px) | Rendered height in pixels |
+   | ≥24×24 (AA) | ✓ if both dimensions are ≥ 24px (WCAG 2.2 Level AA) |
+   | ≥44×44 (AAA) | ✓ if both dimensions are ≥ 44px (WCAG 2.2 Level AAA) |
+
+Elements counted as focusable include: links with `href`, buttons, inputs, selects, textareas, `summary`, `[contenteditable="true"]`, and elements with a non-negative `tabindex`. Hidden or zero-size elements are excluded.
+
+### Example report snippet
+
+```markdown
+# Focusable elements target size – http://localhost:8000/olh/
+
+Generated: 2025-03-05T12:00:00.000Z
+Total focusable elements: 8
+
+| # | Tag | Name / Label | Width (px) | Height (px) | ≥24×24 (AA) | ≥44×44 (AAA) |
+|---|-----|--------------|------------|-------------|-------------|--------------|
+| 1 | a   | Home         | 48         | 24          | ✓           | ✓            |
+| 2 | button | Submit    | 80         | 36          | ✓           | ✗            |
+```
+
+Use this report to find controls that are too small for touch or pointer and to plan fixes (e.g. larger hit areas or spacing).

a11y/playwright/package-lock.json

@@ -0,0 +1,15 @@
+{
+  "name": "playwright",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {},
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "@types/node": "^25.3.3"
+  }
+}

a11y/playwright/package.json

@@ -0,0 +1,82 @@
+// @ts-check
+import { defineConfig, devices } from '@playwright/test';
+
+/**
+ * Read environment variables from file.
+ * https://github.com/motdotla/dotenv
+ */
+// import dotenv from 'dotenv';
+// import path from 'path';
+// dotenv.config({ path: path.resolve(__dirname, '.env') });
+
+/**
+ * @see https://playwright.dev/docs/test-configuration
+ */
+export default defineConfig({
+  testDir: './tests',
+  testMatch: ['**/*.@(spec|test).?(c|m)[jt]s?(x)', '**/target_size.js'],
+  /* Run tests in files in parallel */
+  fullyParallel: true,
+  /* Fail the build on CI if you accidentally left test.only in the source code. */
+  forbidOnly: !!process.env.CI,
+  /* Retry on CI only */
+  retries: process.env.CI ? 2 : 0,
+  /* Opt out of parallel tests on CI. */
+  workers: process.env.CI ? 1 : undefined,
+  /* Reporter to use. See https://playwright.dev/docs/test-reporters */
+  reporter: 'html',
+  /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+  use: {
+    /* Base URL to use in actions like `await page.goto('')`. */
+    // baseURL: 'http://localhost:3000',
+
+    /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+    trace: 'on-first-retry',
+  },
+
+  /* Configure projects for major browsers */
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
+
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
+
+    /* Test against mobile viewports. */
+    // {
+    //   name: 'Mobile Chrome',
+    //   use: { ...devices['Pixel 5'] },
+    // },
+    // {
+    //   name: 'Mobile Safari',
+    //   use: { ...devices['iPhone 12'] },
+    // },
+
+    /* Test against branded browsers. */
+    // {
+    //   name: 'Microsoft Edge',
+    //   use: { ...devices['Desktop Edge'], channel: 'msedge' },
+    // },
+    // {
+    //   name: 'Google Chrome',
+    //   use: { ...devices['Desktop Chrome'], channel: 'chrome' },
+    // },
+  ],
+
+  /* Run your local dev server before starting the tests */
+  // webServer: {
+  //   command: 'npm run start',
+  //   url: 'http://localhost:3000',
+  //   reuseExistingServer: !process.env.CI,
+  // },
+});
+

a11y/playwright/playwright.config.js

@@ -0,0 +1,19 @@
+// @ts-check
+import { test, expect } from '@playwright/test';
+
+test('has title', async ({ page }) => {
+  await page.goto('https://playwright.dev/');
+
+  // Expect a title "to contain" a substring.
+  await expect(page).toHaveTitle(/Playwright/);
+});
+
+test('get started link', async ({ page }) => {
+  await page.goto('https://playwright.dev/');
+
+  // Click the get started link.
+  await page.getByRole('link', { name: 'Get started' }).click();
+
+  // Expects page to have a heading with the name of Installation.
+  await expect(page.getByRole('heading', { name: 'Installation' })).toBeVisible();
+});