Вcем привет, такой вопрос -  в проектах, должен ли фронт всецело доверять ответам, которые задокументированы в описании api метода ? Или же он обязан у себя перед обработкой ответа от бэка проверить, что ему пришел ожидаемый формат данных и только при успешной проверке формата ответа выполнять какую-то логику с ним, а, если формат хоть немного отличается от задокументированного, то считать его "ошибочным" и, например, отображать заглушку какую-нибудь (аля произошла ошибка при получении данных") ?


Например.
Есть метод get-user-info. В api-документации описано, что при  успешном ответе, возвращается объект с  фамилией, именем и отчеством. Необходимо ли делать что-то типа такой проверки (в данном кейсе можно проверять, что ответом является объект, содержащий три строчки: фамилия, имя и отчество):

try {
  const  { data  } = await Axios.get(GET_FIO);
  if (isValidResponse(data)) {
    //логика обработки в случае ожидаемого формата респонса
  } else throw new Error();
} catch (e) {
  //логика обработки ошибочного запроса (статус не равен 2xx) и если не прошел isValidResponse
}

Отлично. А как этот процесс "проверки данных, возвращаемых в ответ на api метод" корректно называется ?

Просто мне хотелось бы загуглить, так как, как мне кажется, явно должны быть специальные библиотеки для реактка/вью, в которых это можно удобно и декларативно описать, нежели в каждом запросе запускать такую произвольную функцию isValidResponse..

Вcем привет, такой вопрос -  в проектах, должен ли фронт всецело доверять ответам, которые задокументированы в описании api метода ? Или же он обязан у себя перед обработкой ответа от бэка проверить, что ему пришел ожидаемый формат данных и только при успешной проверке формата ответа выполнять какую-то логику с ним, а, если формат хоть немного отличается от задокументированного, то считать его "ошибочным" и, например, отображать заглушку какую-нибудь (аля произошла ошибка при получении данных") ?


Например.
Есть метод get-user-info. В api-документации описано, что при  успешном ответе, возвращается объект с  фамилией, именем и отчеством. Необходимо ли делать что-то типа такой проверки (в данном кейсе можно проверять, что ответом является объект, содержащий три строчки: фамилия, имя и отчество):

try {
  const  { data  } = await Axios.get(GET_FIO);
  if (isValidResponse(data)) {
    //логика обработки в случае ожидаемого формата респонса
  } else throw new Error();
} catch (e) {
  //логика обработки ошибочного запроса (статус не равен 2xx) и если не прошел isValidResponse
}

Должен доверять. Все должны доверять. Это же публичный контракт.

А зачем это? Какой то сложный сахар.

Для описания контрактов которые работают и в runtime и в compile-time

почему сразу не предлагать сваггер или типа того, для документации апи?

Контракты

А какие решения для такого определения ожидаемого контракта при axios запросах можете порекомендовать для vue-проекта из личного опыта ?

Не очень понятно, почему такой механизм не предполагают сами библиотеки, с помощью которых делаются api запросы. Ведь было бы удобно, например, в сам axios в вызов запроса прокидывать объект с ожидаемым форматом данных и в случае не соответствия, axios просто возвращал бы rejected промис с соответствующим месседжем в объекте ошибки (как он делает запросами со статусом, отличным от 2xx)..

А какие решения для такого определения ожидаемого контракта при axios запросах можете порекомендовать для vue-проекта из личного опыта ?

Не очень понятно, почему такой механизм не предполагают сами библиотеки, с помощью которых делаются api запросы. Ведь было бы удобно, например, в сам axios в вызов запроса прокидывать объект с ожидаемым форматом данных и в случае не соответствия, axios просто возвращал бы rejected промис с соответствующим месседжем в объекте ошибки (как он делает запросами со статусом, отличным от 2xx)..