Test basati su snapshot e preview

Alcuni bug non causano crash: sono problemi di layout che si notano solo guardando. I test snapshot li rilevano confrontando immagini delle view. 👀

Un test snapshot esegue il rendering di una view come immagine, la salva e in seguito fallisce se un nuovo rendering non corrisponde più.

La prima esecuzione registra un'immagine di riferimento attendibile. La esamina visivamente e da quel momento diventa la fonte di verità.

I preview di SwiftUI mostrano già una view in molti stati. Progettare prima questi stati rende semplice scrivere gli snapshot.

Aggiunga preview per gli stati vuoto, di caricamento e di errore. Ognuno diventa uno snapshot, così vengono rilevate le regressioni in qualsiasi stato.

Esegua il rendering di ogni view in modalità chiara e scura. Un colore che scompare in modalità scura è esattamente il tipo di problema che uno snapshot rivela. 🌗

Esegua uno snapshot della view anche con la dimensione massima di Dynamic Type. Il confronto fallirà subito se il testo fuoriesce o viene tagliato.

Esegua sempre lo snapshot su un dispositivo o un frame fissi. Dimensioni dello schermo diverse producono immagini diverse e causano falsi fallimenti.

Quando uno snapshot fallisce, lo strumento mostra il risultato precedente, quello nuovo e una differenza. Sta a lei decidere: è un bug reale o una modifica intenzionale da registrare nuovamente?

Conservi le immagini di riferimento nel controllo versione. I membri del team condivideranno così la stessa baseline e CI potrà rilevare le modifiche visive nelle pull request.

Ha modificato intenzionalmente il design? Attivi la record mode una volta per aggiornare le baseline, poi la disattivi nuovamente.

Ha imparato a eseguire test snapshot: registrare un riferimento, coprire molti stati dei preview, testare le modalità chiara e scura ed eseguire il commit delle baseline, così i bug visivi non passano inosservati. 🎉