re:re:actable
Урок 043 минуты чтения

Какие status codes нужно знать?

На этой странице
Кратко

HTTP status code показывает результат обработки запроса. Коды делятся на классы: 1xx informational, 2xx success, 3xx redirects, 4xx client errors, 5xx server errors.

Вопрос

Какие классы status codes существуют? Какие коды нужно знать frontend-разработчику и как на них реагировать?

Классы status codes

КлассСмыслПример
1xxпромежуточная информация100 Continue
2xxуспех200 OK
3xxredirect/cache navigation301, 302, 304
4xxошибка клиента400, 401, 404
5xxошибка сервера500, 503

Самые частые 2xx

КодКогда использовать
200 OKзапрос успешно выполнен, есть body
201 Createdресурс создан
202 Acceptedзапрос принят, обработка будет позже
204 No Contentуспешно, но body нет

Самые частые 3xx

КодКогда встречается
301 Moved Permanentlyпостоянный redirect
302 Foundвременный redirect
304 Not Modifiedbrowser может использовать cache

304 часто появляется при cache validation через ETag или Last-Modified.

Самые частые 4xx

КодСмысл
400 Bad Requestзапрос некорректный
401 Unauthorizedпользователь не authenticated
403 Forbiddenauthenticated, но нет прав
404 Not Foundресурс не найден
409 Conflictконфликт состояния
422 Unprocessable Contentданные синтаксически ок, но не проходят бизнес-валидацию
429 Too Many Requestsrate limit

Самые частые 5xx

КодСмысл
500 Internal Server Errorнепредвиденная ошибка сервера
502 Bad Gatewayproxy/gateway получил плохой ответ
503 Service Unavailableсервис временно недоступен
504 Gateway Timeoutupstream не ответил вовремя

Как frontend должен реагировать?

const response = await fetch('/api/users/1');
 
if (response.status === 401) {
  redirectToLogin();
}
 
if (response.status === 403) {
  showForbiddenMessage();
}
 
if (!response.ok) {
  showError();
}

fetch не бросает exception на 404 или 500. Он бросает exception на сетевые ошибки, CORS-блокировку или отмену запроса.

Что важно помнить

  • 301 и 308 — постоянный redirect, 302 и 307 — временный. 307/308 гарантируют сохранение метода и body, а 301/302 браузеры часто превращают POST в GET.
  • 304 не означает ошибку: это ответ на conditional request, браузер берет тело из cache.
  • fetch автоматически следует redirect, поэтому в коде обычно виден конечный status, а response.redirected показывает, что redirect был.
  • 503 с header Retry-After подсказывает, когда повторить запрос.
  • Не показывайте пользователю технический status: переводите его в понятное сообщение и действие.

Мини-шпаргалка

  • 2xx - успех.
  • 3xx - redirect или cache validation.
  • 4xx - проблема в request/client state.
  • 5xx - проблема на server/upstream.
  • 401 - не вошел в систему.
  • 403 - вошел, но нельзя.
  • fetch требует ручной проверки response.ok.

Документация

MDN: Коды ответа HTTP.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам