Lezione gratuita

Creare un progetto di test isolato

Creare un progetto di test isolato — Testare un sito AI con Playwright. Installare il runner ufficiale; Creare sito e server sintetici; Configurare baseURL e webServer. Esercitazione pratica: Prove del laboratorio.

Versione demo. I materiali sono in fase di revisione editoriale.

Argomenti trattati

  • Installare il runner ufficiale
  • Creare sito e server sintetici
  • Configurare baseURL e webServer

Installare il runner ufficiale

Inizializza Playwright in una cartella nuova. Scegli TypeScript e tests; rimanda CI alla sesta lezione. Installa i browser supportati necessari.

Il bersaglio è un sito locale sintetico con un contesto browser separato creato dal runner. Non contiene account, acquisti o messaggi reali. Verifica comportamenti visibili anziché dettagli casuali dell’implementazione AI. Un test riuscito copre soltanto i casi dichiarati, senza provare accessibilità completa, sicurezza o ogni dispositivo. Conserva la revisione manuale per le aree escluse e dichiara questo limite nel rapporto.

mkdir browser-lab
cd browser-lab
npm init playwright@latest
npx playwright --version
npx playwright install chromium

Creare sito e server sintetici

Salva tre file alla radice. Il modulo modifica solo lo stato locale; privacy è un vero percorso locale. Nessuna richiesta esterna o iscrizione reale.

Quando copi il listato separa i linguaggi: HTML in index.html e privacy.html, modulo Node in server.mjs. È un insieme didattico, non un file eseguibile unico. Rimuovi gli spec generati diretti a siti esterni prima di eseguire la suite locale.

Salva gli esempi nei percorsi indicati e separa avvio e test. Usa baseURL anziché indirizzi ripetuti. Le assertion web attendono risultati osservabili; pause fisse rallentano senza provare disponibilità. In caso di errore conserva la trace e riproduci l’input prima di cambiare selettori. Un’etichetta accessibile mancante è spesso un difetto applicativo, non una ragione per nasconderlo con un selettore CSS fragile.

<!-- index.html -->
<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Workshop demo</title><style>body{font:1.1rem/1.6 system-ui;margin:1rem;max-width:60rem}input{max-width:100%;font:inherit}p{overflow-wrap:anywhere}:focus-visible{outline:3px solid #9b4300}</style><main><h1>Workshop demo</h1><a href="#details">Session details</a><section id="details"><h2>Session details</h2><p>Tuesday, six places. Fictional example.</p></section><form><label for="email">Fictional email</label><input id="email" type="email" required><button>Check demo</button><p role="status"></p></form><a href="/privacy">Privacy</a></main><script>document.querySelector('form').onsubmit=e=>{e.preventDefault();document.querySelector('[role=status]').textContent='Demo checked. Nothing sent.';};</script></html>
<!-- privacy.html: save the following as a separate file -->
<!doctype html><html lang="en"><title>Privacy demo</title><main><h1>Privacy demo</h1><p>No submission is sent by this synthetic page.</p><a href="/">Home</a></main></html>
// server.mjs: separate file
import http from 'node:http';import {readFile} from 'node:fs/promises';
const routes={'/':'index.html','/privacy':'privacy.html'};
http.createServer(async(req,res)=>{const file=req.method==='GET'?routes[req.url]:null;if(!file){res.writeHead(404);return res.end('Not found');}try{const data=await readFile(file);res.writeHead(200,{'Content-Type':'text/html; charset=utf-8'});res.end(data);}catch{res.writeHead(500);res.end('Fixture unavailable');}}).listen(4173,'127.0.0.1');

Configurare baseURL e webServer

Sostituisci la configurazione con questo setup Chromium. Il runner avvia un server nuovo; una porta occupata è un errore, non motivo per riusare un’altra app.

Mantieni test indipendenti con input inventati come learner@example.test. Non riusare profili personali autenticati né credenziali reali negli artefatti. Screenshot e trace possono contenere testo, richieste e valori: controllali prima di condividerli. Un successo al secondo tentativo può indicare instabilità, non autorizza a ignorare il primo errore. Riporta comando, progetto browser e risultato effettivo, distinguendo copertura e ipotesi.

// playwright.config.ts
import {defineConfig,devices} from '@playwright/test';
export default defineConfig({testDir:'./tests',use:{baseURL:'http://127.0.0.1:4173',trace:'retain-on-failure'},webServer:{command:'node server.mjs',url:'http://127.0.0.1:4173',reuseExistingServer:false},projects:[{name:'chromium',use:{...devices['Desktop Chrome']}}]});

Esercitazione pratica

Prove del laboratorio

Vai alla lezione

Programma del corso

  1. Creare un progetto di test isolato
  2. Usare fixture per setup affidabile
  3. Scegliere selettori riconoscibili
  4. Provare risultati di moduli e navigazione
  5. Verificare responsive e isolamento
  6. Eseguire CI e interpretare guasti