Testare și QA: dovedește că merge.
Un site cu scroll poate arăta perfect pe laptopul tău și se poate strica pe un telefon, cu un cititor de ecran sau cu mișcarea oprită. Verifică o dată de mână, apoi lasă testele să verifice la fiecare schimbare.
Ce vei învăța
La finalul capitolului- 01Parcurgi de mână o listă de verificare înaintea fiecărei lansări.
- 02Scrii teste în browser cu Playwright pentru încărcare, apariții și mișcare redusă.
- 03Adaugi un audit automat de accesibilitate cu axe și verifici tastatura de mână.
- 04Prinzi schimbările vizuale cu comparații de capturi și testezi pe dispozitive reale.
01 · Lista pentru lansare
0 din 12 bifateBifele se salvează doar în acest browser, așa că se pot pierde într-o fereastră privată.
02 · Cere dovezi
Nu accepta „testat”
Uneltele AI raportează uneori verificări pe care nu le-au rulat. Întreabă ce s-a rulat, la ce lățimi și ce s-a sărit. Apoi deschide pagina și uită-te tu.
Listează fiecare verificare pe care chiar ai rulat-o, cu lățimea sau unealta folosită. Listează fiecare verificare pe care n-ai putut-o rula și de ce.Măsoară, apoi repară
În Chrome DevTools, tabul Lighthouse dă scoruri de performanță și accesibilitate. Repară întâi cea mai mare problemă și rulează din nou. Tabul Performance arată ce blochează firul principal în timp ce derulezi.
Greșeli frecvente
Fișierul deschis direct în loc de printr-un server. Doctype lipsă, care strică Lenis. Scroll snap pe toată pagina împreună cu scroll lin. Deplasări de parallax care împing textul hero-ului în afara ecranului pe telefon. will-change pe fiecare element. Conținut ascuns din CSS pe care niciun script nu-l mai arată. overflow: hidden pe html sau body, care poate lăsa două contexte de scroll.
03 · Teste în browser
PlaywrightInstalează
Playwright conduce browsere reale, Chromium, Firefox și WebKit, la dimensiuni de desktop și de telefon.
npm init playwright@latestDouă dimensiuni de ecran
// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
testDir: 'tests',
projects: [
{ name: 'desktop', use: { ...devices['Desktop Chrome'] } },
{ name: 'phone', use: { ...devices['Pixel 7'] } },
],
// servește folderul cât rulează testele
webServer: { command: 'npx serve -l 3000 .', url: 'http://localhost:3000' },
use: { baseURL: 'http://localhost:3000' },
});Trei teste de care are nevoie orice site cu scroll
Nicio eroare la încărcare, fiecare element ascuns arătat când ajungi la el și o pagină care se citește și cu mișcarea redusă.
// tests/site.spec.ts
import { test, expect } from '@playwright/test';
test('se încarcă fără erori în consolă', async ({ page }) => {
const errors: string[] = [];
page.on('console', (m) => m.type() === 'error' && errors.push(m.text()));
page.on('pageerror', (e) => errors.push(e.message));
await page.goto('/');
await expect(page.locator('h1')).toBeVisible();
expect(errors).toEqual([]);
});
test('fiecare apariție devine vizibilă când ajungi la ea', async ({ page }) => {
await page.goto('/');
for (const el of await page.locator('.reveal').all()) {
await el.scrollIntoViewIfNeeded();
await expect(el).toHaveClass(/\bin\b/);
}
});
test('mișcare redusă: conținutul se vede fără efecte de scroll', async ({ page }) => {
await page.emulateMedia({ reducedMotion: 'reduce' });
await page.goto('/');
await expect(page.locator('.reveal').first()).toHaveCSS('transform', 'none');
});Rulează-le cu npx playwright test. Adaugă --ui ca să urmărești fiecare pas într-un browser.
04 · Audit de accesibilitate
axeVerificări automate
axe prinde etichete lipsă, contrast slab, roluri greșite și capcane de focus. Găsește cam o treime din problemele reale, deci completează testul cu tastatura, nu îl înlocuiește.
npm install -D @axe-core/playwright// tests/a11y.spec.ts
import { test, expect } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';
test('nicio problemă de accesibilitate', async ({ page }) => {
// verifici de două ori: la încărcare (cuvinte stinse, conținut încă neapărut) și după ce
// derulezi o dată prin pagină. Termină întâi tranzițiile (nu buclele
// infinite, care nu se pot termina), altfel contrastul se măsoară la jumătatea lor.
const finish = () => page.evaluate(() => document.getAnimations().filter((a) => a.effect?.getComputedTiming().endTime !== Infinity).forEach((a) => a.finish()));
await page.goto('/');
await finish();
expect((await new AxeBuilder({ page }).analyze()).violations).toEqual([]);
await page.evaluate(async () => {
for (let y = 0; y < document.body.scrollHeight; y += innerHeight / 2) {
scrollTo(0, y);
await new Promise((r) => setTimeout(r, 50));
}
});
await finish();
expect((await new AxeBuilder({ page }).analyze()).violations).toEqual([]);
});De mână
Treci cu Tab prin toată pagina: focusul se vede mereu, ordinea are sens, nimic nu se blochează într-o secțiune fixată. Apoi pornește VoiceOver sau NVDA și ascultă primul ecran.
05 · Comparații de capturi
Prinzi schimbările vizualeCompară cu o imagine salvată
Prima rulare salvează o captură; rulările următoare pică atunci când pagina arată altfel. Oprește animațiile, ca imaginea să fie aceeași de fiecare dată.
test('hero-ul arată ca data trecută', async ({ page }) => {
await page.goto('/');
// animațiile sunt oprite la final, ca imaginea să fie stabilă
await expect(page).toHaveScreenshot('hero.png', { animations: 'disabled' });
});Actualizează intenționat imaginile salvate cu npx playwright test --update-snapshots, după ce te-ai uitat la diferență.
06 · Dispozitive reale
Ce nu pot simți testeleUn iPhone cu Safari
Bara de adresă care se redimensionează, 100vh față de 100svh și scrollul cu inerție se poartă altfel decât în Chrome.
Un telefon Android de gamă medie
Dispozitivul pe care îl folosesc de fapt cei mai mulți vizitatori. Dacă scrollul sacadează aici, sacadează pentru ei.
O rotiță de mouse și un trackpad
Rotița sare în trepte, trackpadul alunecă. Scrollul lin și scenele derulate trebuie să se simtă bine cu amândouă.
Tastatură și mișcare redusă
Space, Page Down și săgețile trebuie să deruleze. Pornește mișcarea redusă din setările sistemului și citește toată pagina o dată.
Practică · Lucrul cu AI
Aceeași sarcină, în unealta taAI-ul scrie repede teste, inclusiv teste care trec mereu. Cere-i să-ți arate fiecare test picând înainte să treacă.
Deschide un terminal în folderul proiectului și rulează claude. Apasă Shift+Tab până se pornește modul plan, lipește promptul, citește planul, apoi aprobă-l. Regulile proiectului stau în CLAUDE.md.
Pregătește Playwright
Citește CLAUDE.md. Pregătește Playwright pentru site-ul pentru [subiect], cu un proiect desktop și unul Pixel 7 și un webServer care servește folderul pe portul 3000. Adaugă trei teste: nicio eroare în consolă la încărcare; fiecare element .reveal primește clasa in după ce ajungi la el; cu mișcare redusă, aparițiile nu au transform. Rulează-le și arată-mi rezultatul.Dovedește că testul poate pica
Pentru fiecare test scris, strică intenționat pagina ca testul să pice, rulează-l, arată-mi eșecul, apoi anulează stricăciunea. Dacă un test nu poate pica, rescrie-l.Deschide un terminal în folderul proiectului și rulează gemini; prima dată te întreabă dacă ai încredere în folder, așa că răspunde da pentru proiectul tău. Lipește promptul. Gemini CLI cere voie înainte să editeze un fișier sau să ruleze o comandă: citește fiecare cerere înainte s-o accepți. Regulile proiectului stau în GEMINI.md.
Pregătește Playwright
Citește GEMINI.md. Pregătește Playwright pentru site-ul pentru [subiect], cu un proiect desktop și unul Pixel 7 și un webServer care servește folderul pe portul 3000. Adaugă trei teste: nicio eroare în consolă la încărcare; fiecare element .reveal primește clasa in după ce ajungi la el; cu mișcare redusă, aparițiile nu au transform. Rulează-le și arată-mi rezultatul.Dovedește că testul poate pica
Pentru fiecare test scris, strică intenționat pagina ca testul să pice, rulează-l, arată-mi eșecul, apoi anulează stricăciunea. Dacă un test nu poate pica, rescrie-l.Deschide un terminal în folderul proiectului, rulează codex, lipește promptul și aprobă fiecare schimbare. În aplicația ChatGPT fără Codex, atașezi fișierele, lipești promptul și copiezi singur schimbările înapoi. Regulile proiectului stau în AGENTS.md.
Pregătește Playwright
Citește AGENTS.md. Pregătește Playwright pentru site-ul pentru [subiect], cu un proiect desktop și unul Pixel 7 și un webServer care servește folderul pe portul 3000. Adaugă trei teste: nicio eroare în consolă la încărcare; fiecare element .reveal primește clasa in după ce ajungi la el; cu mișcare redusă, aparițiile nu au transform. Rulează-le și arată-mi rezultatul.Dovedește că testul poate pica
Pentru fiecare test scris, strică intenționat pagina ca testul să pice, rulează-l, arată-mi eșecul, apoi anulează stricăciunea. Dacă un test nu poate pica, rescrie-l.Practică · Exerciții
Încearcă, apoi comparăUn test care nu poate pica
Ce e greșit în expect(await page.locator('.reveal').count()).toBeGreaterThanOrEqual(0)?
Indiciu: poate un număr de elemente să fie negativ?
Arată soluția
Trece mereu, deci nu dovedește nimic. Testează comportamentul: derulează la fiecare apariție și așteaptă să aibă clasa in.
Ce nu vede axe
Numește două probleme de accesibilitate pe care un audit automat nu le găsește pe un site cu scroll.
Indiciu: gândește-te la ordine și la mișcare.
Arată soluția
De exemplu: o secțiune fixată care prinde focusul tastaturii, o ordine a focusului care sare prin pagină, mișcare prea rapidă sau prea amplă și text citit în ordinea greșită de un cititor de ecran. Pentru ele ai nevoie de tastatură și de un cititor de ecran.
Capturi stabile
Testul cu capturi pică la fiecare rulare, deși nu s-a schimbat nimic. De ce?
Indiciu: ce se mișcă singur în pagină?
Arată soluția
Animații, un marquee, un canvas cu particule sau o dată. Folosește animations: 'disabled', ascunde sau maschează părțile care se mișcă cu opțiunea mask și așteaptă fonturile înainte de captură.
Practică · Proiectul cursului
Un site, construit pe tot parcursulFă site-ul pentru [subiect] să se verifice singur, ca schimbările de mai târziu să nu-l poată strica pe nesimțite.
- Parcurge lista pentru lansare din partea de sus a acestui capitol.
- Rulează „Pregătește Playwright”, apoi „Dovedește că testul poate pica”.
- Adaugă testul axe și un test cu captura hero-ului, cu animațiile oprite.
- Testează pe un iPhone și pe un telefon Android, cu tastatura și cu mișcare redusă.
Practică · Testează
Verifici rezultatulnpx playwright testtrece pe desktop și pe telefon.- Fiecare test pică atunci când comportamentul verificat e stricat intenționat.
- Testul axe nu raportează probleme.
- Testul cu capturi trece de două ori la rând fără schimbări.
Practică · Evaluare
Criterii de acceptare0 din 4 criterii îndeplinite