Formater Flow
Formatuj typowany kod JavaScript Flow za pomocą tego formatera Flow. Wklej kod z aliasami typów, dokładnymi typami obiektów, adnotowanymi funkcjami lub pragmą @flow, a narzędzie uporządkuje go token po tokenie, stosując wcięcia z dwóch spacji, odstępy przy adnotacjach typów i operatorach, średniki na końcu instrukcji oraz zwarte nawiasy dokładnych typów obiektów. Przydatne dla programistów utrzymujących bazy kodu Flow, którzy chcą przygotować przejrzyste fragmenty do przeglądów, migracji i dokumentacji.
Najczęściej zadawane pytania
Jak działa formater Flow?
Dzieli kod na tokeny, takie jak nawiasy klamrowe, średniki, operatory, ciągi znaków i komentarze, a następnie na ich podstawie odtwarza układ. Bloki są wcinane o dwie spacje, instrukcje kończą się średnikami, a operatory otrzymują spójne odstępy.
Jak formatowane są dokładne typy obiektów?
W dokładnych typach obiektów pionowe kreski przylegają bezpośrednio do nawiasów klamrowych, z odstępem wewnątrz, na przykład type Props = {| name: string, age: number |}. Odstępy po dwukropkach i przecinkach wewnątrz typu są ujednolicane.
Czy komentarz @flow jest zachowywany?
Tak, pragma // @flow oraz wszystkie pozostałe komentarze wierszowe i blokowe są zachowywane. Komentarz wierszowy zawsze kończy wiersz, dlatego następujący po nim kod rozpoczyna się w nowym wierszu.
Czy formater sprawdza typy w moim kodzie?
Nie, nie uruchamia Flow ani nie weryfikuje składni, więc formatuje także niekompletne fragmenty kodu. Uruchom flow check w swoim projekcie, aby znaleźć błędy typów.
Czy typy generyczne i parametry typów są zachowywane?
Tak, nawiasy ostrokątne w typach takich jak Array<string> lub Map<K, V> są śledzone, aby nie zostały pomylone z operatorami porównania. Odstępy po przecinkach wewnątrz nich są ujednolicane.
Czy mogę zmienić szerokość wcięcia?
Nie, wynik zawsze używa dwóch spacji i nie ma opcji stylu. Dzięki temu formatowanie jest spójne między kolejnymi uruchomieniami i członkami zespołu.
Czy ciągi znaków są zmieniane?
Nie, literały ciągów znaków, literały szablonowe i wyrażenia regularne są kopiowane dokładnie tak, jak zostały zapisane. Zmieniane są tylko białe znaki między tokenami.
Dlaczego wynik jest otoczony blokiem javascript?
Flow jest typowany JavaScript, dlatego wynik jest zwracany jako blok kodu Markdown oznaczony jako javascript, który większość narzędzi do podświetlania składni wyświetla poprawnie. Skopiuj wiersze między znacznikami ogrodzenia do pliku .js lub .flow.
Czy formatowanie zmieni działanie mojego kodu?
Narzędzie jedynie zmienia układ białych znaków i dodaje średniki na końcach instrukcji. Sprawdź wynik, jeśli Twój kod zależy od wierszy bez średników, które zaczynają się od nawiasu okrągłego lub kwadratowego.
Ile kodu mogę sformatować?
Do 5 MB kodu na jedno uruchomienie; większe dane wejściowe są odrzucane z komunikatem. Wynik jest identyczny z opcją Flow w narzędziu Code Formatter.