Как отформатировать код JavaScript с отступами

Что делает форматировщик JavaScript

JavaScript Formatter помогает привести текст JavaScript к более удобному для чтения виду или уменьшить его объём за счёт режима минификации. Инструмент принимает текст JavaScript и возвращает отформатированный текст в выбранном режиме. Это удобно, когда нужно быстро проверить структуру большого фрагмента, привести отступы к одному размеру или подготовить компактную версию без ручного редактирования. Форматирование меняет представление текста, но не заменяет проверку синтаксиса, компиляцию или запуск программы.

Как отформатировать код

Подготовьте текст JavaScript и вставьте его в поле ввода. Для непустого текста размер входных данных не должен превышать 1 000 000 байт в UTF-8. Строковый ввод обрабатывается как JavaScript-текст; значение другого типа обычно не форматируется. Пустая строка или ввод только из пробелов обрабатывается отдельно: результатом становится пустой отформатированный текст.
Выберите режим beautify, если нужен читаемый код с отступами, или minify, если требуется компактное представление. Если режим не задан или передано ложное значение, выбирается beautify. Строковое название режима приводится к нижнему регистру: minify включает минификацию, а другое строковое значение приводит к beautify. Поэтому для предсказуемого результата используйте одно из этих двух названий.
Укажите размер отступа для непустого текста. Допустимы целые значения от 0 до 8 включительно. Если значение нельзя преобразовать в целое число или оно выходит за этот диапазон, инструмент заменяет его двумя пробелами. При значении по умолчанию также используются два пробела. Нулевой отступ допустим, хотя такой результат может быть менее удобен для чтения.
Запустите обработку и просмотрите полученный текст. В режиме beautify сохраняется выбранный размер отступа, исходные переводы строк сохраняются в пределах ограничения до двух последовательных пустых строк, а завершающий перевод строки не добавляется. Пробелы внутри круглых скобок не вставляются. В режиме minify удаляются комментарии строк и блоков за пределами строковых литералов, подходящие пробелы сворачиваются, повторяющиеся пустые строки сокращаются, а пробелы по краям обрезаются.
Сравните результат с исходником перед использованием. Убедитесь, что важные строковые литералы и экранированные символы сохранились: при минификации содержимое строк, включая такие символы, не изменяется. Если обработка завершается ошибкой, проверьте размер и тип входа, выбранный режим и доступность требуемой зависимости форматирования JavaScript.

Как читать результат и понимать ограничения

Отформатированный результат показывает изменённую запись текста, а не новое выполнение программы. В beautify переносы строк и отступы помогают читать вложенность, но отсутствие завершающего перевода строки само по себе не означает ошибку. Сохранение отдельных переводов строк ограничено двумя последовательными пустыми строками, поэтому точная структура пробелов из исходника может отличаться.

Minify предназначен для сокращения визуального оформления. Комментарии вне строковых литералов удаляются, пробелы в подходящих местах объединяются, а содержимое строковых литералов остаётся с экранированием. Это не даёт оснований считать результат проверенным, скомпилированным или семантически эквивалентным исходнику. После минификации особенно важно проверить места, где пробелы, комментарии и литералы имеют значение для конкретного синтаксиса.

Пустой или состоящий из пробелов ввод не следует трактовать как сбой: он успешно возвращает пустой текст. Для непустого ввода размер отступа нормализуется к допустимому диапазону, а некорректное значение заменяется двумя пробелами. При большом тексте, неподходящем типе данных или недоступной зависимости форматирование может завершиться ошибкой. Если передаётся нестандартное истинное значение режима, которое нельзя привести к нижнему регистру, обработка также может не выполниться.

Практический пример

Разработчик хочет привести небольшой фрагмент JavaScript к читаемому виду перед просмотром изменений и затем получить его компактное текстовое представление.

Разработчик вставляет функцию с условием, выбирает beautify и задаёт четыре пробела, затем повторяет обработку в режиме minify и сравнивает две версии текста.

В режиме beautify результат содержит переводы строк и выбранные отступы, а в режиме minify представляет тот же фрагмент в более компактном виде с сохранённым содержимым строковых литералов.

Ограничения

Минификация меняет оформление текста, но не подтверждает корректность, выполнение или семантическую эквивалентность JavaScript; для непустого ввода также требуется доступная зависимость форматирования.

Частые ошибки

Причина: в поле режима передано истинное значение нестрокового типа, для которого нельзя выполнить приведение к нижнему регистру. Исправление: укажите строковое значение minify или beautify либо оставьте режим пустым для beautify.

Частые вопросы

Можно ли настроить размер отступа?

Да, но только для непустого текста: допустимы целые значения от 0 до 8. Непреобразуемое или выходящее за диапазон значение заменяется двумя пробелами; значение по умолчанию также равно двум пробелам.

Что произойдёт при пустом вводе?

Да. Пустая строка и ввод только из пробелов успешно обрабатываются, а результатом становится пустой отформатированный текст.

Что именно делает минификация?

Режим minify удаляет комментарии вне строковых литералов, сворачивает подходящие пробелы, сокращает повторяющиеся пустые строки и обрезает пробелы по краям. Это не является проверкой, компиляцией или запуском JavaScript.