Форматувальник Flow
Форматуйте типізований код Flow JavaScript за допомогою цього форматувальника Flow. Вставте код із псевдонімами типів, точними типами об’єктів, анотованими функціями або прагмою @flow — інструмент перебудує його токен за токеном: використає відступи у два пробіли, пробіли в анотаціях типів і навколо операторів, крапки з комою в кінці інструкцій і щільні фігурні дужки точних типів об’єктів. Стане в пригоді розробникам, які підтримують кодові бази Flow і хочуть підготувати охайні фрагменти для перевірки, міграцій і документації.
Поширені запитання
Як працює форматувальник Flow?
Він розбиває ваш код на токени, зокрема дужки, крапки з комою, оператори, рядки й коментарі, а потім перебудовує структуру на їх основі. Блоки отримують відступ у два пробіли, інструкції завершуються крапками з комою, а оператори мають однакові пробіли.
Як форматуються точні типи об’єктів?
У точних типах об’єктів вертикальні риски залишаються безпосередньо біля дужок, а всередині ставиться пробіл, наприклад type Props = {| name: string, age: number |}. Пробіли після двокрапок і ком усередині типу нормалізуються.
Чи зберігається коментар @flow?
Так, прагма // @flow і всі інші рядкові та блочні коментарі зберігаються. Рядковий коментар завжди завершує свій рядок, тому наступний код починається з нового рядка.
Чи перевіряє форматувальник типи в моєму коді?
Ні, він не запускає Flow і не перевіряє синтаксис, тому форматує також незавершені фрагменти. Щоб знайти помилки типів, запустіть flow check у своєму проєкті.
Узагальнення та параметри типів зберігаються?
Так, кутові дужки в типах, наприклад Array<string> або Map<K, V>, відстежуються, щоб їх не сприймали як оператори порівняння. Пробіли після ком усередині дужок нормалізуються.
Чи можна змінити ширину відступу?
Ні, у вихідному коді завжди використовуються два пробіли, і налаштувань стилю немає. Завдяки цьому форматування залишається однаковим під час кожного запуску й для всіх учасників команди.
Чи змінюються рядки?
Ні, рядкові літерали, шаблонні літерали й регулярні вирази копіюються точно так, як їх написано. Змінюються лише пробіли між токенами.
Чому вихід обрамлено блоком коду javascript?
Flow типізований JavaScript, тому результат повертається як блок коду Markdown з позначкою javascript, який коректно підсвічує більшість засобів підсвічування синтаксису. Скопіюйте рядки між роздільниками у свій файл .js або .flow.
Чи змінить форматування поведінку мого коду?
Інструмент лише переставляє пробіли та додає крапки з комою в кінці інструкцій. Перевірте результат, якщо ваш код залежить від рядків без крапки з комою, які починаються з круглої або квадратної дужки.
Який обсяг коду можна відформатувати?
До 5 MB коду за один запуск; більший обсяг відхиляється з повідомленням. Результат ідентичний опції Flow у форматувачі коду.