test(app): Playwright and axe browser suite on Chromium (D14)

@playwright/test 1.64.1 and @axe-core/playwright 4.14.0, dev only and pinned. pnpm e2e:ui runs a Vite server of its own on 127.0.0.1:5191 with no backend: the Dialog contract on a dev-only test page and the local tool's dialogs, desktop and 375 px, FR and EN, axe at zero serious violation outside one listed pre-existing finding. Requests outside the allowlist are aborted and fail the test.
This commit is contained in:
bchanot committed 2026-10-25 22:36:43 +01:00
1 parent 6f885eccb2
commit 72ee9f9971
11 files changed
+740 -3

No files matched your search

+216
View File
@@ -0,0 +1,216 @@
import { en } from '@/i18n/en'
import { fr } from '@/i18n/fr'
import {
expect,
expectAccessible,
expectNoHorizontalOverflow,
focusOwner,
focusedName,
test,
} from '../support/browser'
import type { Page } from '@playwright/test'
// The D13 contract of components/ui/Dialog on its test page (e2e/harness/dialog.tsx).
async function openScenario(page: Page, opener: string, title: string) {
await page.getByRole('button', { name: opener }).focus()
await page.keyboard.press('Enter')
const dialog = page.getByRole('dialog', { name: title })
await expect(dialog).toBeVisible()
return dialog
}
/** Names of the elements the focus visits over `count` presses of `key`. */
async function focusWalk(page: Page, key: 'Tab' | 'Shift+Tab', count: number) {
const visited: { owner: string; name: string }[] = []
for (let i = 0; i < count; i++) {
await page.keyboard.press(key)
visited.push({
owner: await focusOwner(page),
name: await focusedName(page),
})
}
return visited
}
test.beforeEach(async ({ page }) => {
await page.goto('/e2e/harness/dialog.html')
await expect(
page.getByRole('heading', { name: 'Dialog harness' }),
).toBeVisible()
})
test('is a named, described modal dialog and moves focus into it', async ({
page,
}) => {
const dialog = await openScenario(page, 'Open basic', 'Basic dialog')
await expect(dialog).toHaveAccessibleDescription('Three controls follow.')
expect(
await dialog.evaluate((d) => d.tagName === 'DIALOG' && d.matches(':modal')),
).toBe(true)
expect(await focusOwner(page)).toBe('dialog')
expect(await focusedName(page)).toBe(fr['common.close'])
})
// Past either end the focus visits the browser's interface (one step, the page
// holds no focus) and comes back into the dialog; it never reaches the page.
test('Tab and Shift+Tab cycle through the dialog, never the page', async ({
page,
}) => {
await openScenario(page, 'Open basic', 'Basic dialog')
const step = (f: { owner: string; name: string }) =>
f.owner === 'dialog' ? f.name : f.owner
const forward = await focusWalk(page, 'Tab', 10)
expect(forward.map(step)).toEqual([
'First',
'Second',
'Done',
'browser',
fr['common.close'],
'First',
'Second',
'Done',
'browser',
fr['common.close'],
])
const backward = await focusWalk(page, 'Shift+Tab', 10)
expect(backward.map(step)).toEqual([
'browser',
'Done',
'Second',
'First',
fr['common.close'],
'browser',
'Done',
'Second',
'First',
fr['common.close'],
])
})
test('the page behind is inert: no focus, no click, no scroll', async ({
page,
}) => {
const dialog = await openScenario(page, 'Open guarded', 'Guarded dialog')
const background = page.getByRole('button', {
name: 'Background action',
includeHidden: true,
})
const box = await background.boundingBox()
if (!box) throw new Error('background button not laid out')
await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2)
await background.evaluate((b) => (b as HTMLElement).focus())
expect(await focusOwner(page)).toBe('dialog')
await page.mouse.move(box.x + 5, box.y + 5)
await page.mouse.wheel(0, 800)
await page.waitForTimeout(200)
expect(await page.evaluate(() => window.scrollY)).toBe(0)
await expect(dialog).toBeVisible()
await expect(page.getByTestId('background-clicks')).toHaveText('0')
})
test('Escape closes when allowed and focus returns to the opener', async ({
page,
}) => {
const dialog = await openScenario(page, 'Open basic', 'Basic dialog')
await page.keyboard.press('Escape')
await expect(dialog).toBeHidden()
expect(await focusedName(page)).toBe('Open basic')
await expect(
page.getByRole('button', { name: 'Background action' }),
).toBeEnabled()
})
test('Escape is only a request: refused twice, the dialog stays open', async ({
page,
}) => {
const dialog = await openScenario(page, 'Open guarded', 'Guarded dialog')
await page.keyboard.press('Escape')
await page.keyboard.press('Escape')
await expect(dialog).toBeVisible()
expect(await dialog.evaluate((d) => (d as HTMLDialogElement).open)).toBe(true)
expect(await focusOwner(page)).toBe('dialog')
await page.getByRole('checkbox', { name: 'Busy' }).uncheck()
await page.keyboard.press('Escape')
await expect(dialog).toBeHidden()
expect(await focusedName(page)).toBe('Open guarded')
})
test('the close button closes from the keyboard and restores focus', async ({
page,
}) => {
const dialog = await openScenario(page, 'Open basic', 'Basic dialog')
expect(await focusedName(page)).toBe(fr['common.close'])
await page.keyboard.press('Enter')
await expect(dialog).toBeHidden()
expect(await focusedName(page)).toBe('Open basic')
})
test('an opener gone on close hands focus to its container’s first control', async ({
page,
}) => {
const dialog = await openScenario(page, 'Remove item', 'Remove the item?')
await page.getByRole('button', { name: 'Confirm removal' }).click()
await expect(dialog).toBeHidden()
await expect(page.getByRole('button', { name: 'Remove item' })).toHaveCount(0)
expect(await focusedName(page)).toBe('Add item')
})
test('long content scrolls inside the panel, the page stays put', async ({
page,
}) => {
const dialog = await openScenario(page, 'Open long', 'Long dialog')
const panel = dialog.locator('header').locator('..')
const { scrollHeight, clientHeight } = await panel.evaluate((p) => ({
scrollHeight: p.scrollHeight,
clientHeight: p.clientHeight,
}))
expect(scrollHeight).toBeGreaterThan(clientHeight)
expect(await focusedName(page)).toBe(fr['common.close'])
await page.keyboard.press('Tab')
const end = page.getByRole('button', { name: 'End of content' })
await expect(end).toBeFocused()
await expect(end).toBeInViewport()
expect(await page.evaluate(() => window.scrollY)).toBe(0)
const box = await panel.boundingBox()
const viewport = page.viewportSize()
expect(
box && viewport && box.y >= 0 && box.y + box.height <= viewport.height,
).toBe(true)
})
test('fits the viewport without horizontal page scroll', async ({ page }) => {
await expectNoHorizontalOverflow(page, 'the page')
for (const [opener, title] of [
['Open basic', 'Basic dialog'],
['Open long', 'Long dialog'],
]) {
const dialog = await openScenario(page, opener, title)
const box = await dialog.locator('header').locator('..').boundingBox()
const width = page.viewportSize()?.width ?? 0
expect(
box && box.x >= 0 && box.x + box.width <= width,
`${title} inside the viewport`,
).toBe(true)
await expectNoHorizontalOverflow(page, title)
await page.keyboard.press('Escape')
await expect(dialog).toBeHidden()
}
})
for (const [lang, dict] of [
['fr', fr],
['en', en],
] as const) {
test(`axe finds no serious violation, close control named in ${lang}`, async ({
page,
}) => {
await page.goto(`/e2e/harness/dialog.html?lang=${lang}`)
await expectAccessible(page, `the harness (${lang})`)
await openScenario(page, 'Open basic', 'Basic dialog')
await expect(
page.getByRole('button', { name: dict['common.close'] }),
).toBeFocused()
await expectAccessible(page, `the open dialog (${lang})`)
})
}
+104
View File
@@ -0,0 +1,104 @@
import { en } from '@/i18n/en'
import { fr } from '@/i18n/fr'
import {
expect,
expectAccessible,
expectNoHorizontalOverflow,
focusOwner,
focusedName,
test,
} from '../support/browser'
import type { Page } from '@playwright/test'
import type { Dict } from '@/i18n/types'
// The shared Dialog where the local tool uses it, on the real routes with no
// backend: the sheet disclaimer, the edit dialog and the replace confirmation.
// Fictitious names only.
const ANIMAL = 'Fictif Alezan'
/** Required label text without the trailing « * » marker. */
const label = (dict: Dict, key: string) => dict[key].replace(/\s*\*$/, '')
async function startReport(page: Page, dict: Dict) {
await page
.getByLabel(label(dict, 'form.practitioner.name'))
.fill('Praticien Fictif')
await page.getByLabel(label(dict, 'form.animal.name')).fill(ANIMAL)
await page
.getByLabel(label(dict, 'form.owner.name'))
.fill('Propriétaire Fictif')
await page.getByRole('button', { name: dict['new_report.submit'] }).click()
}
for (const [locale, dict] of [
['fr-FR', fr],
['en-GB', en],
] as const) {
test.describe(`local tool (${locale})`, () => {
test.use({ locale, forbiddenInUrls: [ANIMAL, 'Fictif'] })
test('editor dialogs: disclaimer, edit, replace confirmation', async ({
page,
}) => {
await page.goto('/')
// Scanned once the sheet is loaded: the import button fades in from disabled.
await expect(
page.getByRole('button', { name: dict['home.import.cta'] }),
).toBeEnabled()
await expectAccessible(page, 'home')
await page
.getByRole('button', { name: dict['home.new_report.cta'] })
.click()
await expect(page).toHaveURL(/\/new$/)
await expectNoHorizontalOverflow(page, 'new report')
await startReport(page, dict)
await expect(page).toHaveURL(/\/editor$/)
const disclaimer = page.getByRole('dialog', {
name: dict['editor.disclaimer_title'],
})
await expect(disclaimer).toBeVisible()
expect(await disclaimer.getAttribute('aria-describedby')).toBeTruthy()
expect(await focusOwner(page)).toBe('dialog')
expect(await focusedName(page)).toBe(dict['common.close'])
await page.keyboard.press('Tab')
expect(await focusedName(page)).toBe(dict['common.understood'])
await expectAccessible(page, 'editor with the disclaimer')
await expectNoHorizontalOverflow(page, 'editor with the disclaimer')
await page.keyboard.press('Escape')
await expect(disclaimer).toBeHidden()
const edit = page.getByRole('button', { name: dict['editor.edit_infos'] })
await edit.focus()
await page.keyboard.press('Enter')
const editDialog = page.getByRole('dialog', {
name: dict['editor.edit_dialog_title'],
})
await expect(editDialog).toBeVisible()
expect(await focusOwner(page)).toBe('dialog')
await expectNoHorizontalOverflow(page, 'edit dialog')
await page.keyboard.press('Escape')
await expect(editDialog).toBeHidden()
await expect(edit).toBeFocused()
// A reload: the bilan stays in the tab, not yet in the store (the « unloaded » message).
await page.goto('/new')
await startReport(page, dict)
const replace = page.getByRole('dialog', {
name: dict['session.replace.title'],
})
await expect(replace).toBeVisible()
await expect(replace).toHaveAccessibleDescription(
dict['session.replace.body_unloaded'],
)
await expectAccessible(page, 'replace confirmation')
await page.keyboard.press('Escape')
await expect(replace).toBeHidden()
await expect(page).toHaveURL(/\/new$/)
await expect(
page.getByRole('button', { name: dict['new_report.submit'] }),
).toBeFocused()
})
})
}