Что делает инструмент
Инструмент берёт сжатый, минифицированный или неаккуратно оформленный код и выводит его в чистом и единообразном стиле. Поддерживаются языки, с которыми чаще всего приходится работать в вебе: HTML, CSS, SCSS, Less, JavaScript, TypeScript, JSON, XML, Markdown, YAML и GraphQL.
Внутри работает Prettier — форматтер, которым пользуются миллионы проектов, поэтому результат выглядит точно так же, как код, отформатированный в VS Code или pre-commit-хуком. Парсер каждого языка загружается только при его выборе, поэтому страница работает быстро.
Как пользоваться
- Выберите Язык вашего кода.
- Вставьте код или откройте файл.
- Выберите стиль Отступа (2 пробела, 4 пробела или табуляция) и Ширину строки. Строки длиннее заданной ширины переносятся там, где это допускает язык.
- Для JavaScript и TypeScript выберите, заканчивать ли инструкции точками с запятой. Для скриптов и стилей включите одинарные кавычки, если они приняты в вашем проекте.
- Скопируйте результат или скачайте его.
Пример
В примере — HTML-страница в одну строку со встроенными CSS и JavaScript. После форматирования каждый элемент стоит на отдельной строке, CSS-правила развёрнуты по одному объявлению в строке, а стрелочная функция в скрипте получает скобки и точку с запятой:
<script>
const items = [1, 2, 3];
items.forEach((i) => console.log(i));
</script>
Советы
- Форматирование — это ещё и быстрая проверка синтаксиса. Если Prettier не может разобрать ввод, в сообщении об ошибке будут строка и столбец, и можно сразу перейти к ошибке.
- XML форматируется так, будто пробельные символы не значимы, чтобы вложенные теги получили отступы. Если ваш документ зависит от точных пробелов внутри элементов, проверьте результат перед использованием.
- Нужно обратное? Используйте минификатор JavaScript и CSS, чтобы сжать код для продакшена, или форматтер JSON для проверки и минификации JSON.
Частые вопросы
› Какой форматтер использует этот инструмент?
Prettier — самый популярный форматтер кода для веб-проектов, который работает полностью в вашем браузере. Поддержка XML обеспечивается официальным плагином Prettier для XML. Результат совпадает с тем, что Prettier выдаёт в редакторе с теми же настройками.
› Меняет ли форматирование поведение кода?
Нет. Prettier меняет только оформление: отступы, переносы строк, пробелы и стиль кавычек. Если в коде есть синтаксическая ошибка, инструмент остановится и укажет строку, а не будет угадывать.
› Почему HTML внутри тегов script и style тоже форматируется?
Форматтер HTML передаёт встроенные CSS и JavaScript соответствующим парсерам Prettier, поэтому вся страница получает единообразные отступы.
› Загружается ли мой код на сервер?
Нет. Форматирование выполняется локально, на сервер ничего не отправляется.