Документы GraphQL
Выберите операции, SDL или переменные JSON. Для проверки полей операции добавьте полную схему в формате SDL.
Документы обрабатываются в этом браузере: без запросов к API, сохранения истории и добавления ввода в URL.
Без схемы проверяется только синтаксис. Полный SDL позволяет статически проверить поля и типы. Переменные проверяются как объект JSON; соответствие значений объявленным типам не проверяется.
Документ и схема: по 100 000 символов; переменные: 20 000. GraphQL: 20 000 токенов, 100 уровней вложенности; остановка через 8 секунд.
Введите документ или загрузите пример.
Форматтер GraphQL помогает разобрать запрос, скопированный из журнала. Вложенные выборки становятся читаемыми, а определения фрагментов остаются рядом с операциями. Результат выводится отдельно, поэтому исходный текст можно сверить с ним.
Корректный синтаксис не означает, что поле существует в вашей API. Строка состояния показывает, проверена ли только грамматика или выполнена статическая проверка по предоставленной схеме.
Форматтер GraphQL расставляет отступы в два пробела и выводит документ целиком. В структуре видны операции, объявления переменных, фрагменты и поля с исходными строками. Ссылки не разворачиваются, а отсутствующие определения не создаются.
Валидатор GraphQL обнаружит неизвестное поле только тогда, когда ему доступна схема GraphQL. Добавьте полный SDL для проверки выборок, аргументов и связей фрагментов. Сообщения укажут, какой источник требует исправления.
Режим операций принимает запросы, мутации, подписки и фрагменты. Отдельный type или extend можно обработать в режиме SDL без корневого типа Query. Режим переменных позволяет работать с JSON независимо от запроса.
В режиме операций вкладки документа, схемы и переменных сохраняют свои данные при переключении. Пример включает все три источника. Перед применением видны новые значения и число символов; возврат восстанавливает также прежний результат.
Автообработка начинается через 400 мс после паузы во вводе. Отключите её, чтобы использовать кнопку или Ctrl/Cmd+Enter. Изменение входных данных блокирует экспорт до нового расчёта; переключение вида результата ничего не пересчитывает.
Форматирование удобно для ревью, а минификация GraphQL удаляет лишние разделители. Обязательные пробелы между именами, значения строк и порядок полей сохраняются. Запрос не переписывается ради оптимизации выполнения.
Операции, объявления переменных, фрагменты, поля и типы SDL выводятся порциями по 100 элементов. JSON-файл структуры содержит весь список, в том числе ещё не показанные записи. Число элементов не является оценкой стоимости запроса.
Переменные JSON сохраняют запись чисел 9007199254740993 и 1.2300e+40. Порядок ключей, включая похожие на числа, остаётся исходным. Повторный ключ вызывает ошибку, а не незаметную потерю одного из значений.
Синтаксические ошибки содержат строку и столбец, когда парсер их предоставляет. Нажатие открывает нужную вкладку. Если нарушена схема, но синтаксис документа верен, отформатированный текст доступен для чтения, а экспорт заблокирован до исправления.
Парсер проверяет соответствие грамматике и без схемы. В режиме операций оставьте схему пустой для проверки только синтаксиса. Успех не подтверждает, что поля существуют на вашем сервере.
Вставьте полный SDL сервера на вкладке схемы, а операцию и нужные фрагменты — в документ. Статические правила проверят поля, аргументы и объявленные типы. Авторизация, выполнение и поведение резолверов не тестируются.
Переменные используют строгий JSON, а не запись входных объектов GraphQL или словари другого языка. Ключи и строки должны быть в двойных кавычках, завершающие запятые недопустимы, корнем должен быть объект. Повторные ключи также отклоняются.
В переданной полной схеме нет допустимого корневого типа запроса. Определите type Query либо укажите существующий объектный тип в объявлении schema. Для форматирования отдельного типа или расширения выберите режим SDL.
Вывод одного узла операции не добавляет определения, находящиеся в другом месте. Здесь выводится весь вставленный документ. Включите необходимые фрагменты в тот же текст; инструмент не читает внешние файлы и не разворачивает ссылки автоматически.
Документ дал неожиданный результат?
Используйте Форматтер GraphQL, проверьте указанный в статусе объём проверки и экспортируйте текущее представление.