Спецификация GraphQL — сентябрь 2025 года: Координаты схемы, OneOf входные данные и описания исполняемых документов

Основное обновление

Фонд GraphQL выпустил сентябрьское издание 2025 года спецификации GraphQL — первое полное издание спецификации с октября 2021 года — которое формально добавляет Координаты схемы (канонические, машинно- и человекочитаемые адреса для элементов схемы), объекты входных данных OneOf (взаимно исключающие формы входных данных), возможность прикреплять описания к исполняемым документам (запросы/мутации/подписки), полную поддержку грамматики Unicode и ряд уточнений по семантике устаревания и исполнения. (graphql.org)

Почему это важно

Это изменения в языке, ориентированные на разработчиков, а не редакционные придирки. Координаты схемы предоставляют инструментам стабильный идентификатор для полей/типов в различных версиях, что позволяет надежно генерировать код, детерминированно проверять код, точно комментировать автоматические PR и улучшать реестры схем. Объекты входных данных OneOf позволяют дизайнерам API моделировать взаимно исключающие входные данные непосредственно в самой схеме, что снижает количество вспомогательной валидации и улучшает типизацию клиентского кода. Описания операций (теперь часть AST документа) означают, что IDE, шлюзы, проверки CI и инструменты на базе LLM могут потреблять документацию на уровне операций нативно, а не полагаясь на хрупкие соглашения о комментариях. Уточненные правила устаревания и исполнения делают изменения и наблюдаемость более предсказуемыми в производственной среде. Реализаторы (генераторы кода, шлюзы и инструменты) должны будут принять обновления спецификации, чтобы в полной мере использовать эти преимущества, но изменения должны существенно улучшить надежность инструментов и автоматизацию для производственных развертываний GraphQL. (graphql.org)

Источник

• Источник