Scrollcraft
Capitolul 13 din 15EN

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.

Capitolul 13 din 153 min de citit

Ce vei învăța

La finalul capitolului
  1. 01Parcurgi de mână o listă de verificare înaintea fiecărei lansări.
  2. 02Scrii teste în browser cu Playwright pentru încărcare, apariții și mișcare redusă.
  3. 03Adaugi un audit automat de accesibilitate cu axe și verifici tastatura de mână.
  4. 04Prinzi schimbările vizuale cu comparații de capturi și testezi pe dispozitive reale.

01 · Lista pentru lansare

0 din 12 bifate

Bifele se salvează doar în acest browser, așa că se pot pierde într-o fereastră privată.

02 · Cere dovezi

a

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.

Prompt
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.
b

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.

c

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

Playwright
a

Instalează

Playwright conduce browsere reale, Chromium, Firefox și WebKit, la dimensiuni de desktop și de telefon.

bash
npm init playwright@latest
b

Două dimensiuni de ecran

playwright.config.ts
// 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' },
});
c

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ă.

site.spec.ts
// 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

axe
a

Verifică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.

bash
npm install -D @axe-core/playwright
a11y.spec.ts
// 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([]);
});
b

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 vizuale
a

Compară 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ă.

site.spec.ts
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 testele
1

Un 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.

2

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.

3

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ă.

4

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 ta

AI-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

Prompt
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

Prompt
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ă
1

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.

2

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.

3

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 parcursul

Fă site-ul pentru [subiect] să se verifice singur, ca schimbările de mai târziu să nu-l poată strica pe nesimțite.

  1. Parcurge lista pentru lansare din partea de sus a acestui capitol.
  2. Rulează „Pregătește Playwright”, apoi „Dovedește că testul poate pica”.
  3. Adaugă testul axe și un test cu captura hero-ului, cu animațiile oprite.
  4. Testează pe un iPhone și pe un telefon Android, cu tastatura și cu mișcare redusă.

Practică · Testează

Verifici rezultatul
  • npx playwright test trece 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 acceptare

0 din 4 criterii îndeplinite

Urmează Producție și lansare

Publici un folder static sau o aplicație Next.js, legi un domeniu, adaugi metadate, automatizezi verificările și ții site-ul sănătos.

Scurtături de tastatură: [ capitolul anterior · ] capitolul următor