Oggi siamo lieti di annunciare il rilascio di Jest 30. Questa versione include un numero sostanziale di modifiche, correzioni e miglioramenti. Pur trattandosi di uno dei maggiori rilasci principali di Jest mai realizzati, riconosciamo che tre anni per una major release sono troppi. In futuro, miriamo a rilasciare major version più frequentemente per mantenere Jest eccellente nel prossimo decennio.

Se vuoi saltare tutte le novità e iniziare subito, esegui npm install jest@^30.0.0 e segui la guida alla migrazione: Aggiornamento da Jest 29 a Jest 30.

Novità​

Jest 30 è notevolmente più veloce, utilizza meno memoria e include tantissime nuove funzionalità. Per prima cosa, diamo un'occhiata ai breaking change:

Modifiche di Rottura​

• Jest 30 rimuove il supporto per Node 14, 16, 19 e 21.

• jest-environment-jsdom è stato aggiornato da jsdom 21 a 26.

• La versione minima compatibile di TypeScript è ora la 5.4.

• Sono stati rimossi vari alias di expect. eslint-plugin-jest include un autofixer che puoi eseguire per aggiornare automaticamente il tuo codice.

• Le proprietà non enumerabili degli oggetti sono ora escluse per impostazione predefinita dai matcher come toEqual.

• Jest supporta ora per impostazione predefinita i file .mts e .cts.

• --testPathPattern è stato rinominato in --testPathPatterns.

• Jest gestisce ora correttamente le promise che vengono prima respinte e poi catturate, evitando falsi positivi nei test.

• Abbiamo apportato vari miglioramenti alla stampa degli snapshot che potrebbero richiedere il loro aggiornamento. Google ha deprecato i link goo.gl che utilizzavamo negli snapshot. Nemmeno a noi piace, ma dovrai aggiornare tutti i tuoi snapshot.

• Jest stesso è ora incluso in un singolo file per pacchetto. Questo migliora le prestazioni, ma potrebbe causare problemi se hai creato strumenti che accedono agli interni di Jest.

Queste sono solo alcune delle novità principali. L'elenco completo dei breaking change è disponibile nel CHANGELOG e nella guida alla migrazione per Jest 30.

Miglioramenti delle prestazioni e della memoria​

Jest 30 offre miglioramenti delle prestazioni nel mondo reale grazie a numerose ottimizzazioni, specialmente nella risoluzione dei moduli, utilizzo della memoria e isolamento dei test. Basandosi sul nuovo unrs-resolver, la risoluzione dei moduli in Jest è diventata più ricca di funzionalità, conforme agli standard e più veloce. Un ringraziamento a @JounQin per la migrazione. A seconda del tuo progetto, potresti osservare esecuzioni dei test significativamente più veloci e un consumo di memoria ridotto. Ad esempio, una grande applicazione TypeScript con client e server ha osservato esecuzioni dei test più veloci del 37% e un utilizzo della memoria inferiore del 77% in una parte del loro codice base:

Jest è veloce, ma a causa dell'isolamento dei test di Jest, il codice utente lento spesso peggiora i problemi di prestazioni e rallenta l'esecuzione dei test. Quando i test lasciano handle aperti come timer non chiusi o connessioni ad altri servizi, Jest potrebbe bloccarsi o rallentare. Jest 30 è migliorato nel rilevare e segnalare questi problemi, aiutandoti a identificare e correggere più facilmente test lenti o problematici. Ad esempio, i test su Happo sono stati accelerati del 50% passando da 14 a 9 minuti grazie alla pulizia degli handle aperti e all'aggiornamento a Jest 30.

Se utilizzi file che consolidano le esportazioni di più moduli in un singolo file (detti "barrel files"), ti consigliamo di usare strumenti come babel-jest-boost, babel-plugin-transform-barrels o no-barrel-file per evitare di caricare grandi quantità di codice dell'applicazione per ogni file di test. Questo può portare a miglioramenti delle prestazioni fino a 100 volte.

Pulizia delle variabili globali tra i file di test​

Jest ottiene l'isolamento dei test tra i file eseguendo ogni test in un contesto VM separato, fornendo a ogni file un ambiente globale pulito. Tuttavia, se il tuo codice non pulisce le variabili globali dopo ogni file di test, ciò può causare perdite di memoria in Jest e rallentare l'esecuzione dei test. Jest 30 introduce una nuova funzionalità che ti avvisa delle variabili globali non pulite correttamente dopo l'esecuzione di un test.

In futuro, Jest pulirà automaticamente le variabili globali dopo ogni esecuzione di test. Se non ricevi alcun avviso riguardo a variabili globali non pulite con Jest 30, puoi già impostare la modalità di pulizia delle globali su 'on' per abilitare completamente questa funzionalità e beneficiare di importanti risparmi di memoria e miglioramenti delle prestazioni:

export default {
  testEnvironmentOptions: {
    globalsCleanup: 'on',
  },
};

L'impostazione predefinita in Jest è globalsCleanup: 'soft'. Per disabilitare questa funzionalità puoi impostarla su off. Se devi proteggere oggetti globali specifici dalla pulizia - ad esempio utility condivise o cache - puoi contrassegnarli come protetti usando jest-util:

import {protectProperties} from 'jest-util';

protectProperties(globalThis['my-property']);

Ringraziamo @eyalroth per aver implementato questa funzionalità!

Nuove funzionalità​

Migliorato il supporto per ECMAScript Module e TypeScript​

È stato aggiunto il supporto per import.meta.* e file:// quando si utilizza ESM nativo con Jest. Inoltre, ora puoi scrivere i tuoi file di configurazione di Jest in TypeScript, e i file .mts e .cts sono supportati nativamente senza necessità di configurazione aggiuntiva. Se utilizzi la funzionalità nativa di Node per la rimozione dei tipi TypeScript, non carichiamo più il transformer TypeScript per rimuovere i tipi, portando a esecuzioni di test più veloci.

Spy e la parola chiave using​

Ora puoi utilizzare la nuova sintassi di gestione esplicita delle risorse di JavaScript (using) con gli spy di Jest. Se il tuo ambiente lo supporta, scrivere using jest.spyOn(obj, 'method') ripristinerà automaticamente lo spy al termine del blocco, quindi non dovrai pulire manualmente.

test('logs a warning', () => {
  using spy = jest.spyOn(console, 'warn');
  doSomeThingWarnWorthy();
  expect(spy).toHaveBeenCalled();
});

Documentazione

expect.arrayOf​

Jest 30 introduce un nuovo matcher asimmetrico, expect.arrayOf, che ti permette di validare ogni elemento di un array rispetto a una condizione o tipo. Ad esempio, puoi verificare che un array contenga solo numeri assicurandoti che tutti gli elementi siano numeri:

expect(someArray).toEqual(expect.arrayOf(expect.any(Number)));

Documentazione

Nuovo segnaposto per test.each: %$​

Se utilizzi test basati sui dati con test.each, ora puoi includere un segnaposto speciale %$ nei titoli dei test per inserire il numero del caso di test. Ad esempio:

test.each(cases)('Case %$ works as expected', () => {});

sostituirà %$ con il numero progressivo del test.

Documentazione

jest.advanceTimersToNextFrame()​

@sinonjs/fake-timers è stato aggiornato alla versione 13, aggiungendo jest.advanceTimersToNextFrame(). Questa nuova funzione ti permette di avanzare tutte le callback requestAnimationFrame in attesa al limite del frame successivo, semplificando il test di animazioni o codice che si basa su requestAnimationFrame senza dover indovinare la durata in millisecondi.

Documentazione

Tentativi di test configurabili​

Jest 30 migliora jest.retryTimes() con nuove opzioni che ti danno il controllo sulla gestione dei tentativi. Puoi specificare un ritardo o ripetere immediatamente un test fallito senza attendere il completamento dell'intera suite di test:

// Retry failed tests up to 3 times, waiting 1 second between attempts:
jest.retryTimes(3, {waitBeforeRetry: 1000});

// Immediately retry without waiting for other tests to finish:
jest.retryTimes(3, {retryImmediately: true});

Documentazione

jest.unstable_unmockModule()​

Jest 30 introduce la nuova API sperimentale jest.unstable_unmockModule() per un controllo più granulare durante la rimozione dei mock dai moduli (soprattutto con ESM nativo).

Documentazione

jest.onGenerateMock(callback)​

È stato aggiunto il nuovo metodo onGenerateMock. Registra una funzione di callback che viene richiamata ogni volta che Jest genera un mock per un modulo, consentendoti di modificarlo prima che venga restituito al tuo ambiente di test:

jest.onGenerateMock((modulePath, moduleMock) => {
  if (modulePath.includes('Database')) {
    moduleMock.connect = jest.fn().mockImplementation(() => {
      console.log('Connected to mock DB');
    });
  }
  return moduleMock;
});

Documentazione

Altri Miglioramenti​

Serializzazione personalizzata degli oggetti​

Le utility di matching di Jest ora supportano la definizione di SERIALIZABLE_PROPERTIES statica sugli oggetti personalizzati. Ciò ti permette di controllare quali proprietà vengono incluse negli snapshot e nei messaggi d'errore, rendendo l'output più mirato e pertinente.

Documentazione

Supporto per configurazione asincrona​

I file di test elencati in setupFilesAfterEnv possono ora esportare funzioni asincrone o usare await di primo livello, analogamente a setupFiles.

E molto altro ancora…​

Consulta il CHANGELOG completo per tutti i cambiamenti, miglioramenti e nuove funzionalità.

Problemi noti​

jsdom ha apportato modifiche per maggiore conformità alle specifiche. Ciò potrebbe interrompere alcuni casi d'uso, in particolare il mocking di window.location nei test. Jest ora include @jest/environment-jsdom-abstract per semplificare la creazione di ambienti di test personalizzati basati su jsdom. Se vuoi solo applicare una patch a jsdom, puoi usare questa patch jsdom per il tuo progetto. In futuro potremmo valutare alternative a jsdom più adatte al testing.

Prossimi passi​

Jest è il framework di testing JavaScript più popolare da un decennio, usato da milioni di sviluppatori su progetti che vanno da piccole librerie ai codebase più grandi al mondo. Sebbene sia stato costantemente migliorato, come tutti i progetti software di lunga durata abbiamo accumulato debito tecnico. Supportiamo funzionalità usate da pochi, mantenendo le breaking change minime per non disturbare gli utenti. Alcune funzionalità dovrebbero essere possibili senza far parte del core, altre promuovono pratiche di testing inadeguate. Alcuni membri del team hanno cambiato ruolo, rallentando i progressi. Ecco come affronteremo queste sfide:

• Prestazioni/Debito tecnico: Snellire il core di Jest rendendolo più leggero e performante, rimuovendo funzionalità poco usate e focalizzandoci sull'essenza di Jest.

• Cicli di rilascio coerenti: Garantiremo maggiore regolarità nei cicli di rilascio e nelle politiche di deprecazione.

• Trasparenza: Costruiremo tutto pubblicamente, comunicando chiaramente i piani. Creeremo più opportunità di contributo per aumentare i collaboratori.

• Siate audaci: Come team di Jest, dovremmo essere più coraggiosi. Ci sono molti fattori che limitano il potenziale completo di Jest. È il momento di agire.

La buona notizia è che Jest è sempre stato impostato perfettamente per rispettare questi principi, fin da quando abbiamo creato il framework come sistema modulare con una chiara separazione delle responsabilità. Ora è il momento di eseguire. Altro su tutto questo a breve!

Ringraziamenti​

Questa release non sarebbe stata possibile senza il duro lavoro della nostra comunità. Grazie.

@SimenB, @mrazauskas, @Connormiha, @liuxingbaoyu, @k-rajat19, @G-Rath, @charpeni, @dubzzz, @stekycz, @yinm, @lencioni, @phawxby, @lukeapage, @robhogan, @fisker, @k-rajat19, @connectdotz, @alesmenzel, @rickhanlonii, @mbelsky, @brunocabral88, @brandon-leapyear, @nicolo-ribaudo, @dj-stormtrooper, @eryue0220

Un ringraziamento speciale a tutti coloro che hanno contribuito per la prima volta a Jest in questa release. Grazie per aver reso Jest migliore per tutti!

@eyalroth, @KhaledElmorsy, @mohammednumaan, @bensternthal, @BondarenkoAlex, @phryneas, @jayvdb, @brandonchinn178, @latin-1, @rmartine-ias, @fa93hws, @Dunqing, @gustav0d, @noritaka1166, @andreibereczki, @Dreamsorcerer, @satanTime, @icholy, @ecraig12345, @cgm-16, @sebastiancarlos, @dancer1325, @loganrosen, @zakingslayerv22, @dev-intj, @tez3998, @anbnyc, @pengqiseven, @thypon, @co63oc, @danielrentz, @jonasongg, @andrew-the-drawer, @phryneas, @hyperupcall, @tonyd33, @madcapnmckay, @dongwa, @gagan-bhullar-tech, @ikonst, @ZuBB, @jzaefferer, @brandonnorsworthy, @henny1105, @DmitryMakhnev, @askoufis, @RahulARanger, @Jon-Biz, @fynsta, @KonnorRogers, @BondarenkoAlex, @mouadhbb, @kemuridama, @Avi-E-Koenig, @davidroeca, @akwodkiewicz, @mukul-turing, @dnicolson, @colinacassidy, @ofekm97, @haze, @Vadimchesh, @peterdenham, @ShuZhong, @manoraj, @nicolo-ribaudo, @georgekaran, @MathieuFedrigo, @hkdobrev, @Germandrummer92, @CheadleCheadle, @notaphplover, @danbeam, @arescrimson, @yepitschunked, @JimminiKin, @DerTimonius, @vkml, @ginabethrussell, @jeremiah-snee-openx, @WillianAgostini, @casey-lentz, @faizanu94, @someone635, @rafaelrabelos, @RayBrokeSomething, @DaniAcu, @mattkubej, @tr1ckydev, @shresthasurav, @the-ress, @Mutesa-Cedric, @nolddor, @alexreardon, @Peeja, @verycosy, @mknight-atl, @maro1993, @Eric-Tyrrell22

Jest 29 è qui, a pochi mesi da Jest 28. Come menzionato nel blog post di Jest 28, questa versione contiene solo un paio di breaking changes, per rendere l'aggiornamento il più fluido possibile.

Oggi siamo entusiasti di annunciare che Jest si unisce alla OpenJS Foundation!

Questo cambiamento trasferisce la proprietà del progetto da Meta al Jest Core team tramite la OpenJS Foundation come Impact Project. Siamo grati a Meta per aver creato Jest e per tutto il supporto offerto nel corso degli anni, e non vediamo l'ora di vedere il futuro di Jest come progetto di proprietà della comunità Jest!

Consulta gli annunci sul blog di Meta Engineering e sul blog della OpenJS Foundation per maggiori informazioni.

Jest 28 è finalmente qui e porta con sé alcune funzionalità richieste da tempo come il supporto per lo sharding dei test su più macchine, gli exports dei pacchetti e la possibilità di personalizzare il comportamento dei fake timers. Questi sono solo alcuni punti salienti personali, e in questo articolo approfondiremo ulteriori novità.

Inoltre, come annunciato nel blog post di Jest 27 dello scorso anno, abbiamo rimosso alcuni pacchetti non più utilizzati per impostazione predefinita dall'installazione standard. Di conseguenza, la dimensione di installazione si è ridotta di circa un terzo.

Circa un anno fa nel post del blog su Jest 26, abbiamo annunciato che dopo due rilasci principali con poche modifiche di rilievo, Jest 27 avrebbe attivato alcune opzioni per impostare valori predefiniti migliori per progetti nuovi o che possono migrare senza problemi. Questo ci dà l'opportunità di rimuovere alcuni pacchetti dalla distribuzione predefinita di Jest 28 e pubblicarli invece come moduli installabili separatamente e collegabili. Chi utilizza le nuove impostazioni predefinite beneficia di dimensioni di installazione ridotte, mentre chi necessita di questi pacchetti può comunque installarli separatamente.

Con il primo grande cambiamento delle impostazioni predefinite dai tempi delle Nuove Impostazioni Predefinite per Jest introdotte con la fondamentale versione 15, Jest 27 è ora qui per mantenere Jest veloce, leggero e rilevante nel futuro. In questo articolo spiegheremo questi cambiamenti nei predefiniti e altre importanti modifiche di rilievo, ma prima scopriamo alcune nuove entusiasmanti funzionalità!

Siamo entusiasti di presentare il nuovo sito web di Jest!

Il sito di Jest è stato aggiornato da Docusaurus 1 a Docusaurus 2, ed è uno dei primi ad adottare il nuovo supporto i18n di Docusaurus 2.

Ma cosa c'è di nuovo esattamente?

Quando abbiamo iniziato a ricostruire Jest cinque anni fa, il nostro obiettivo era fornire un test runner "completo di tutto" senza configurazione, accessibile per i principianti, estensibile per quasi tutti i casi d'uso dei test e scalabile per grandi progetti. Una delle release fondamentali fu Jest 15 che unificò tutto e fornì impostazioni predefinite valide, consentendo alle persone di eseguire Jest spesso senza alcuna configurazione. Tuttavia, questo approccio ha un grosso svantaggio: Jest installa molte dipendenze nei vostri progetti che potreste non necessitare.

Stiamo ora iniziando a risolvere questa carenza e stiamo lavorando per ridurre la dimensione dell'installazione di Jest mantenendolo accessibile ed estensibile. Abbiamo apportato le seguenti modifiche sostanziali in Jest 26:

Jest 25 sta gettando le fondamenta per molti cambiamenti significativi futuri. Abbiamo mantenuto al minimo le modifiche breaking, ma i cambiamenti all'architettura interna potrebbero richiedere attenzione durante l'aggiornamento. Le principali novità includono l'aggiornamento di JSDOM dalla versione 11 alla 15, test eseguiti dal 10% al 15% più velocemente, una nuova visualizzazione diff per gli snapshot obsoleti e l'abbandono del supporto per Node 6.

Sono stati effettuati oltre 200 commit da più di 80 contributor da Jest 24.9, quindi come sempre, consulta il changelog per l'elenco completo delle modifiche.

Oggi siamo lieti di annunciare la prossima release principale di Jest - la versione 24! Sono passati 4 mesi dall'ultima release minore e 8 mesi da Jest 23, quindi questo aggiornamento è importante e offre qualcosa per tutti! I punti salienti includono il supporto nativo per TypeScript grazie all'aggiornamento degli interni di Jest a Babel 7, la risoluzione di problemi persistenti come l'output mancante della console e i problemi di prestazioni nel calcolo di diff complessi, oltre a un nuovissimo sito web scintillante. ✨

Per l'elenco completo di tutte le modifiche, consulta il changelog.

Jest è mantenuto da una comunità di contributori open source e dipendenti di Facebook.

I nostri contributori open source lavorano per conto della comunità per creare nuove funzionalità, correggere bug e gestire il backlog dei problemi. I dipendenti Facebook svolgono lo stesso lavoro, concentrandosi su problematiche specifiche della scala di Facebook, e testano tutte le release proposte sull'enorme suite di test di Facebook prima della pubblicazione.

Tutti noi facciamo la nostra parte per rendere i test un'esperienza piacevole.

Al Jest Summit abbiamo annunciato lo Jest Open Collective. Questo è il nostro modo di sostenere gli sforzi della comunità open source di Jest. Per essere assolutamente chiari: i dipendenti Facebook non possono beneficiare dello Jest Open Collective. L'unico scopo del collective è supportare il lato open source della comunità Jest.

In questo articolo descriveremo cos'è lo Jest Open Collective, la sua struttura e gli obiettivi che ci siamo posti.