Перейти к содержанию

Форматер GraphQL

Форматируйте или минифицируйте GraphQL запросы, мутации, фрагменты или схемы с согласованным отступом.

Входные данные
Выходные данные

Форматер GraphQL

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

Выберите ширину отступа (2 пробела, 4 пробела или табуляция) или включите "Минифицировать вместо форматирования", чтобы удалить пробелы и комментарии до самого короткого допустимого документа. "Сортировать поля по алфавиту" переупорядочивает поля в каждом наборе выбора или блоке типа, что полезно для поиска пропущенного или дублированного поля в большом запросе. "Свернуть переменные запроса в одну строку" определяет, остаётся ли список переменных операции на одной строке или разбивается на отдельные строки с отступом для каждой переменной, а "Пустая строка между операциями" добавляет интервалы, когда вход содержит более одного запроса, мутации или фрагмента. `$variable: Type` остаётся на одной строке или разбивается на собственную строку с отступом для каждой переменной, а "Пустая строка между операциями" добавляет интервалы, когда вход содержит более одного запроса, мутации или фрагмента.

Инструмент также проверяет во время форматирования: несовпадающие или незакрытые скобки сообщаются вместо того, чтобы угадываться, и набор выборов, который распределяет фрагмент (`...MyFragment`) без відповідного визначення у вставленому тексті, позначається. Таблиця відображає, скільки визначень було знайдено і наскільки глибоко вкладена операція — ранній знак надмірної выборки.

Форматирование выполняется полностью в вашем браузере — ничего из того, что вы вставляете, не загружается, что важно для схем и запросов, которые ссылаются на внутренние имена полей или типов. Скопируйте результат, загрузите его как файл .txt или отправьте вывод обратно в ввод для применения другого прохода с другими параметрами.

FAQ

Работает ли это с определениями схем (SDL), а не только с запросами?
Да. Блоки типов, интерфейсов, входов, перечислений, объединений, скаляров и схем форматируются с тем же согласованным отступом, что и операции, и "Сортировать поля по алфавиту" применяется также к их полям.
Что происходит, если мой запрос ссылается на фрагмент, который не находится в файле?
Инструмент по-прежнему форматирует остальную часть документа, но строка, распределяющая отсутствующий фрагмент, помечается, чтобы вы могли вставить его определение или исправить опечатку в его названии.
Могу ли я использовать это, чтобы уменьшить запрос перед отправкой по сети?
Да — включите "Минифицировать вместо форматирования", чтобы удалить комментарии и ненужные пробелы до самого маленького допустимого документа, сохраняя при этом семантическую идентичность запроса.
Сохраняются ли комментарии?
По умолчанию да: комментарии # и описания сохраняются на отдельной строке выше того, что они описывают. Отключите "Сохранять комментарии", чтобы удалить их, что также происходит автоматически при минификации.
Загружается ли мой запрос или схема куда-нибудь?
Нет. Форматирование и минификация выполняются полностью в вашем браузере — ничего из того, что вы вставляете, никогда не покидает ваше устройство.