Retry-логика

Retry-логика является неотъемлемой частью разработки современных веб-приложений, где важно обеспечить стабильность и отказоустойчивость при работе с удалёнными сервисами или динамическими данными. В библиотеке Unpoly предусмотрены механизмы для обработки неудачных запросов, что позволяет автоматизировать повторные попытки и значительно улучшить пользовательский опыт.

Основные принципы retry-логики

Retry-логика заключается в том, чтобы повторно пытаться выполнить неудавшийся запрос через заданные интервалы времени и с определённым количеством попыток. В контексте Unpoly, это чаще всего применяется к запросам AJAX, которые выполняются для загрузки новых данных или обновления контента на странице.

Важные параметры для настройки retry-логики в Unpoly

Unpoly предлагает несколько ключевых параметров для настройки retry-логики, которые позволяют гибко управлять частотой, количеством попыток и условиями повторного запроса. Вот основные из них:

Параметр retry

Параметр retry является основным для настройки логики повторных запросов. Он принимает объект, в котором можно задать следующие настройки:

  • retries — количество повторных попыток, которое будет сделано перед тем, как запрос будет признан неудачным.
  • delay — интервал времени между попытками, который может быть как фиксированным, так и динамическим (например, с экспоненциальным увеличением).
  • backoff — алгоритм задержки между попытками. Может быть задан как число или функция для более гибкой настройки.

Пример настройки параметра retry:

up.auto({
  retry: {
    retries: 3,
    delay: 1000, // 1 секунда
    backoff: 'exponential' // экспоненциальное увеличение интервала
  }
});

Параметр onRetry

Кроме стандартных настроек количества повторов и задержки, Unpoly позволяет настроить событие onRetry, которое срабатывает перед каждой новой попыткой. Это может быть полезно для логирования, пользовательского уведомления или иных действий, которые нужно выполнить перед повтором запроса.

Пример использования onRetry:

up.auto({
  retry: {
    retries: 3,
    delay: 1000,
    onRetry: function (attempt) {
      console.log(`Попытка №${attempt}`);
    }
  }
});

Параметр onError

Этот параметр позволяет настроить поведение при окончательном провале всех попыток. Он срабатывает, если все повторные попытки не увенчались успехом. В нём можно указать логику обработки ошибки, например, уведомление пользователя о проблеме с соединением.

Пример:

up.auto({
  retry: {
    retries: 3,
    onError: function (error) {
      alert('Произошла ошибка при загрузке данных. Попробуйте позже.');
    }
  }
});

Экспоненциальная задержка

Для предотвращения перегрузки сервера или чрезмерного использования ресурсов на клиенте, retry-логика может использовать алгоритм экспоненциальной задержки. Это значит, что с каждой новой попыткой интервал между запросами увеличивается, что позволяет уменьшить вероятность очередных ошибок в случае временных сбоев на сервере или сети.

Unpoly поддерживает экспоненциальное увеличение задержки по умолчанию, однако это поведение можно настроить. Параметр backoff в настройках retry может принимать значение exponential, что гарантирует увеличение интервала между запросами в 2 раза после каждой неудачной попытки.

Пример настройки экспоненциальной задержки:

up.auto({
  retry: {
    retries: 5,
    delay: 500,  // Начальная задержка 500 миллисекунд
    backoff: 'exponential'
  }
});

В этом примере первая задержка составит 500 миллисекунд, вторая — 1000 миллисекунд, третья — 2000 миллисекунд, и так далее.

Как работает retry-логика в Unpoly

При установке параметра retry библиотека будет автоматически отслеживать ошибки сетевых запросов и, в случае неудачи, будет пытаться выполнить повторный запрос, соблюдая заданные условия.

  1. Запрос неудачен: если запрос завершился с ошибкой (например, 500 ошибка сервера или ошибка сети), Unpoly анализирует параметры retry.
  2. Повторный запрос: если количество попыток ещё не исчерпано, происходит задержка и выполняется новый запрос.
  3. Максимальное количество попыток: если все попытки не дали результата, вызывается onError, и дальнейшие действия зависят от логики, прописанной в этом коллбэке.

Применение retry-логики с различными типами ошибок

Важно настроить retry-логику таким образом, чтобы она не пыталась повторить запросы в случаях, когда это явно не имеет смысла. Например, ошибки клиента, такие как неправильный запрос (400 ошибка), вряд ли будут исправлены повторными попытками. В таких случаях полезно ограничить повторные попытки только ошибками сервера или сетевых проблем.

Для этого можно использовать параметр shouldRetry, который позволяет вручную указать, следует ли повторять запрос в зависимости от кода ошибки.

Пример настройки с условием повторных попыток:

up.auto({
  retry: {
    retries: 3,
    shouldRetry: function (response) {
      return response.status >= 500 && response.status < 600; // Повторять только в случае ошибок сервера
    }
  }
});

Лучшие практики

  1. Ограничение числа попыток: слишком большое количество попыток может привести к нагрузке на сервер или зацикливанию. Рекомендуется использовать разумные пределы, такие как 3-5 повторов.
  2. Использование экспоненциальной задержки: для предотвращения дальнейших сбоев из-за перегрузки сервера или проблемы с сетью стоит использовать экспоненциальный бэкофф.
  3. Логирование ошибок: всегда полезно логировать ошибки, особенно если они касаются сетевых сбоев или ошибок на сервере. Это поможет в диагностике и отладке.
  4. Обработка пользовательских ошибок: избегайте применения retry-логики для ошибок, связанных с неверными запросами от клиента (например, 400). В таких случаях лучше сразу уведомить пользователя.

Заключение

Retry-логика в Unpoly предоставляет мощные инструменты для повышения надёжности веб-приложений при работе с асинхронными запросами. Конфигурируемые параметры, такие как количество повторов, задержка между попытками и условия для повторных запросов, позволяют адаптировать поведение системы под любые условия и задачи.

Оглавление