benchmarking

Skill do pisania i uruchamiania testów wydajności dla pakietów Jazz. Zawiera konfigurację biblioteki cronometro, konwencje nazewnictwa plików, obsługę wątków roboczych i metody porównywania różnych implementacji. Użyj go, gdy chcesz zmierzyć starą vs nową wersję kodu, zweryfikować, że refaktor nie pogorszył wydajności, lub porównać kod w workspace z opublikowaną wersją na npm.

1. Umieść pliki benchmarku w katalogu bench/ w korzeniu repozytorium. Każdy plik powinien mieć nazwę wzoru <subject>.<operation>.bench.ts, np. comap.create.jazz-tools.bench.ts lub filestream.getChunks.bench.ts. 2. Zainstaluj zależności benchmarkowe w bench/package.json: cronometro, cojson, jazz-tools i vitest. 3. Utwórz plik benchmarku importując cronometro i definiując obiekty testowe. Każdy obiekt powinien zawierać funkcję before() do przygotowania danych (uruchamia się raz przed iteracjami) i funkcję test() zawierającą kod do pomiaru. 4. Zdefiniuj wiele implementacji w jednym pliku — na przykład "operation - @latest" i "operation - @workspace" — aby porównać wydajność starej i nowej wersji. 5. Uruchom benchmark za pomocą cronometro, które automatycznie uruchomi każdy test w izolowanym wątku roboczym dla dokładnych pomiarów. 6. Przeanalizuj wyniki, aby zidentyfikować regresje wydajności lub potwierdzić, że optymalizacja rzeczywiście poprawiła czas wykonania.