Generator testowych danych CSV

Generator testowych danych CSV – Faker.js w przeglądarce

Testowanie aplikacji wymaga danych – baz pełnych realistycznych rekordów zamiast "test1", "test2". Narzędzie generuje pliki CSV z fałszywymi ale wiarygodnymi danymi (Faker.js): imiona, adresy email, numery telefonu, PESEL-podobne ID, daty, adresy IP.

Jak działa generator danych testowych CSV

Generator nie buduje całego pliku naraz, tylko przechodzi wiersz po wierszu przez zdefiniowany schemat. Schemat to uporządkowana lista kolumn — każda ma nazwę, typ i własne parametry, takie jak zakres dat (startDate → endDate), przedział min/max z dokładnością do określonej liczby miejsc po przecinku, lista wartości (enum), formuła albo licznik sekwencji. W każdym przebiegu pętli narzędzie wywołuje dla danej kolumny regułę przypisaną do jej typu i pobiera wynik ze słownika Faker.js dla wybranej lokalizacji.

Kluczowa jest niezależność losowań. Wartość w kolumnie powstaje tylko na podstawie jej własnej reguły — nie zagląda do pozostałych kolumn tego samego wiersza. Dlatego imię i nazwisko nie tworzą spójnej pary z adresem email, a miasto nie jest powiązane z kodem pocztowym ani ulicą. Taki model jest wystarczający do testowania importu, wydajności zapytań i walidacji formatów, ale nie do testów relacji między danymi.

Po zebraniu wierszy narzędzie składa tekst CSV: najpierw opcjonalny wiersz nagłówka, potem rekordy, w których pola rozdziela wybrany separator, a cudzysłowy dokłada zgodnie z ustawieniem — wszystkie pola albo tylko te, które zawierają separator, cudzysłów lub znak nowej linii. Na końcu stosuje wybrane kodowanie. Przy większej liczbie wierszy plik nie trafia do podglądu, lecz jest generowany strumieniowo i udostępniany jako plik do pobrania, co odciąża przeglądarkę.

Przykład: schemat pięciu kolumn krok po kroku

1. Dodaj kolumnę id i ustaw jej typ na Sekwencja (auto-increment). Kolejne wiersze otrzymają wartości 1, 2, 3… — rosnące o stały krok, zgodnie z kolejnością rekordów w pliku.
2. Dodaj kolumnę first_name i wybierz lokalizację Polska (pl). Słownik zwróci imiona w rodzaju Jan, Agnieszka. Dodaj obok last_name — pamiętaj, że imię i nazwisko pochodzą z dwóch niezależnych losowań i nie tworzą realnej osoby.
3. Dodaj kolumnę email (typ Osobiste). Powstanie adres z domeną wygenerowaną przez Faker.js, niezależny od wartości first_name i last_name w tym samym wierszu — nie oczekuj adresu w stylu imie.nazwisko@domena.
4. Dodaj kolumnę birthdate i ustaw zakres od startDate do endDate. Każda data jest losowana z tego przedziału, a wynik zapisuje się w formacie obsługiwanym przez wybrany typ kolumny.
5. Dodaj kolumnę city (Adresy, lokalizacja pl) — pojawią się miejscowości takie jak Kraków czy Poznań. Przeciągnij kolumny w panelu tak, aby ich kolejność odpowiadała kolejności pól w tabeli docelowej.
6. Ustaw liczbę wierszy w zakresie od 10 do 100 000, wybierz separator, zdecyduj o nagłówku i kodowaniu, a następnie uruchom generowanie. Jeśli liczba wierszy przekracza 10 000, plik od razu trafia do pobrania zamiast do podglądu.

Ustawienia pliku CSV — tabela referencyjna

Praktyczne wskazówki przed generowaniem pliku

• Dopasuj separator do odbiorcy pliku. Jeśli CSV ma wylądować w polskim Excelu, średnik bywa bezpieczniejszy niż przecinek, bo ten sam znak pełni rolę separatora dziesiętnego. Do skryptów i bibliotek parserów w większości przypadków wystarczy przecinek.
• Włącz UTF-8 BOM, gdy plik otwiera człowiek. Bez znacznika BOM arkusz kalkulacyjny może źle odczytać polskie znaki diakrytyczne, mimo poprawnego kodowania UTF-8. Windows-1250 wybieraj tylko wtedy, gdy odbiorcą jest starszy system.
• Zostaw nagłówek włączony przy testach importu. Wiersz z nazwami kolumn pozwala sprawdzić mapowanie pól, a wyłączenie nagłówka przydaje się do testów walidacji „brak wymaganego wiersza 1”.
• Dobierz liczbę wierszy do celu testu. Kilkadziesiąt rekordów wystarcza do sprawdzenia parsera, tysiące — do oceny czasu importu. Pamiętaj, że powyżej 10 000 wierszy plik nie jest wyświetlany w podglądzie, więc wynik ocenisz dopiero po pobraniu.
• Używaj listy wartości zamiast typu losowego, gdy potrzebujesz kontroli. Enum typu active|inactive|pending daje przewidywalny zbiór wariantów i pozwala testować filtrowanie oraz sortowanie bez zgadywania, jakie wartości się pojawią.

Ograniczenia i czynniki, które zaburzają wynik

• Brak spójności między kolumnami. Narzędzie losuje każdą wartość osobno, więc adres email nie wynika z imienia i nazwiska, a miasto nie odpowiada kodowi pocztowemu ani ulicy. Testy zależności między polami trzeba przygotować inaczej.
• Formatu nie należy utożsamiać z walidacją. Identyfikatory w stylu PESEL, numery telefonu w formacie 48xxxxxxxxx, IBAN w formacie PL czy fałszywe numery kart płatniczych są generowane jako dane tekstowe o odpowiednim kształcie. Nie zakładaj, że przejdą sumy kontrolne lub walidację operatora płatności.
• Losowość może pokryć się z rzeczywistością. Dane są fikcyjne, ale słowniki imion, miejscowości i domen są realne — pojedynczy rekord może przypadkiem przypominać istniejącą osobę albo adres. Dlatego takich plików nie wolno wykorzystywać jako danych produkcyjnych.
• Rozmiar pliku zależy od liczby kolumn i długości wartości. Przy szerokim schemacie i dużej liczbie wierszy generowanie w przeglądarce trwa dłużej i zużywa więcej pamięci, a plik zamiast podglądu jest udostępniany do pobrania.
• Brak relacji między osobnymi generowaniami. Dwa pliki utworzone z podobnym schematem nie podzielą wspólnych kluczy, więc nie zastąpią zestawu tabel połączonych kluczami obcymi.

Najczęstsze pytania

Powiązane narzędzia: generator testowego JSON API, konwerter CSV na JSON i walidator CSV.