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