Простыми словами
Например, в проекте команда фиксирует практику «Сохранённые GraphQL-запросы» как отдельное правило, добавляет автоматическую проверку и наблюдаемый критерий результата. Поэтому проверяют весь путь запроса от браузера до сервера и обратно - иначе локально правильное решение может ухудшить загрузку, совместимость или устойчивость страницы.
Пример при разработке
В проекте команда фиксирует практику «Сохранённые GraphQL-запросы» как отдельное правило, добавляет автоматическую проверку и наблюдаемый критерий результата.
Это редакционный пример применения, а не часть определения или доказательство концепции.Формальное определение
Клиент передаёт идентификатор заранее зарегистрированного запроса вместо произвольного текста операции.
Механизм действия
Для «Сохранённые GraphQL-запросы» команда задаёт явные границы, проверяемый контракт и сигнал, по которому видно соблюдение или нарушение правила.
Пример в работе
Использовать «Сохранённые GraphQL-запросы» как термин без владельца, критерия и проверки реального поведения.
Связать «Сохранённые GraphQL-запросы» с конкретным риском, тестом или метрикой и пересматривать правило при изменении контекста.
Ограничения
Практика «Сохранённые GraphQL-запросы» решает ограниченную задачу и не заменяет анализ всей системы, проверку исходных допущений и измерение побочных эффектов.
Источник
GraphQL Foundation, “GraphQL Specification”, 2021.