Livewire 4.4.6: documentazione più chiara, validazione più rapida e test più affidabili

La release v4.4.6 di Livewire è un aggiornamento di consolidamento: nessuna breaking change, ma parecchie correzioni alla documentazione di Livewire 4, un piccolo miglioramento prestazionale sulla validazione e nuove assertion per la suite di test. Vediamo i punti che contano davvero.

Documentazione: form, Alpine e upload sotto la lente

La fetta più grande delle modifiche riguarda la documentazione, con l'obiettivo di eliminare gli esempi ambigui che spesso generano confusione nei progetti reali:

• Form e validazione: chiarito il flusso del quickstart, in particolare quando viene eseguita la validazione rispetto alla Form Request. Un dettaglio che incide sul debug quotidiano.
• Alpine: corretto l'esempio di save-on-blur e aggiunto un avviso esplicito contro la doppia installazione di Alpine durante il setup, causa classica di comportamenti duplicati nel frontend.
• Eventi JavaScript: sistemato l'accesso al payload all'interno dei listener, che negli esempi precedenti non rispecchiava il comportamento reale.
• Upload di file: l'esempio di testing ora è allineato al componente mostrato, e c'è una nuova sezione dedicata al cropping delle immagini prima dell'upload.
• Qualità generale: corretta la sintassi PHP negli esempi di nesting e uniformato l'uso di Pest in tutta la documentazione di Livewire 4.

Prestazioni: validazione dei form più snella

Il cambiamento tecnico più interessante è il salto dei controlli ridondanti sulle regole di validazione dei form: le regole già verificate non vengono più rieseguite inutilmente. Su componenti con form complessi e molte regole, il guadagno si nota soprattutto nelle richieste ripetute durante la digitazione.

Testing: più controllo sui componenti e sugli eventi

Il ramo 4.x riceve diverse migliorie all'API di test, utili a rendere le assertion meno fragili:

• Nuove assertion per i componenti il cui rendering è stato saltato, così puoi verificare esplicitamente che un componente non venga renderizzato.
• Le assertion sulle callback degli eventi ora controllano tutti gli eventi corrispondenti, non solo il primo trovato.
• I tipi dei test Livewire vengono preservati dopo le assertion sulla response, evitando di perdere il contesto della catena di assertion.

In sintesi

Aggiornamento consigliato e a basso rischio: basta un composer update livewire/livewire. Se stai seguendo la documentazione di Livewire 4 per form, Alpine o upload, vale la pena rileggere le sezioni citate perché diversi esempi sono cambiati. Le novità sul fronte test sono invece un buon momento per rivedere le assertion sui componenti saltati e sugli eventi.

Riferimenti: release ufficiali di Livewire.