Pokrytie test262

test262 je oficiálna testovacia sada zhody, ktorú spravuje TC39, a štandardný spôsob porovnávania enginov JavaScript.

Phasis prechádza celú sadu na úrovni 100 % vo všetkých kategóriách — sémantika jazyka, štandardná knižnica, Intl, annexB, zastarané webové funkcie, priečinok staging s pripravovanými testami a vlastné testy testovacieho prostredia. Bez obchádzania pomocou príznakov funkcií, bez zoznamu nevyriešených medzier hostiteľa a bez vylúčení jednotlivých častí testov.

Testovacia sada je pevne určená: podmodul test262 git určuje revíziu, voči ktorej sa meria Phasis, a nové testy z nadradeného projektu sa započítajú až po aktualizácii podmodulu. Snímka celej testovacej sady v COMPAT.md sa obnovuje pracovným postupom compat-matrix.yml, ktorý sa spúšťa ručne, nie pri každom odoslaní zmien; COMPAT.md zaznamenáva, kedy bola snímka vytvorená a voči ktorému commitu.

Na porovnanie, test262.fyi sleduje tú istú testovaciu sadu voči každému produkčnému enginu JS:

V každom z týchto enginov zostáva malá medzera (nedávno pridané návrhy, zriedkavé hraničné prípady, ktoré sa ešte pripravujú). Phasis túto medzeru vypĺňa tým, že ide o implementáciu zameranú výhradne na zhodu.

Lokálne spustenie

Runner potrebuje podmodul test262 a testovacie triedy repozitára, ktoré nie sú súčasťou balíka Composer, preto ho spustite z klonu repozitára:

git clone https://github.com/inline0/phasis
cd phasis
git submodule update --init test262
composer install
./bin/test262 --jobs 4

Úplné spustenie na novšom Macu trvá približne 20 minút; v CI sa testy rozdelia do súbežných častí a dokončia za niekoľko minút.

Ak chcete pri ladení spustiť iba jednu kategóriu:

./bin/test262 --category built-ins/Array
./bin/test262 --category language/expressions/yield --failures

Úplnú sadu príznakov nájdete v referenčnej príručke CLI.

Prečo je to dôležité

JavaScript má jemné sémantické nuansy — NaN !== NaN, -0 === 0, [1] + 1 === "11", presné poradie enumerácie vlastností a načasovanie mikrotaskov Promise. Knižnica, ktorá spúšťa používateľský kód JS, musí vždy správne zvládnuť každú z nich. Hranicu toho, čo znamená „správne“, určuje test262; pri úspešnosti 100 % program JS, ktorý beží na V8, vytvára na Phasis bajtovo identický výstup (s výnimkou API dostupných iba v prehliadači).