Deprecation
DeprecationУведомитель об устаревании

Уведомитель об устаревании

Included in the “Power Extensions” bundle

Отправляет уведомления об устаревании в ответе на запрос (а не только при выполнении интроспекции), в разделе верхнего уровня extensions.

Описание

Всякий раз, когда запрашивается устаревшее поле, сообщение об устаревании возвращается в том же GraphQL-ответе, в разделе верхнего уровня extensions.

Это предупреждает пользователей наших API о необходимости обновить работу со схемой, даже если они не обращают внимания на запрос интроспекции.

Например, при выполнении этого запроса, где поле isPublished является устаревшим:

query {
  posts {
    title
    isPublished
  }
}

...будет получен следующий ответ:

{
  "extensions": {
    "deprecations": [
      {
        "message": "Use 'isStatus(status:published)' instead of 'isPublished'",
        "extensions": {
          ...
        }
      }
    ]
  },
  "data": {
    "posts": [
      ...
    ]
  }
}