Search packages, repositories and app categories

ducafecatFlutter ecosystem guide
Package detailsv2.0.8

dio_retry_plus

A plugin for dio that retries failed requests.

AndroidiOSWebmacOSWindowsLinux
pub.dev API documentation Source code
30-day downloads
837
Likes
29
Pub points
120

Install package

flutter pub add dio_retry_plus

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

dio_retry_plus is a Flutter package that extends Dio, a popular HTTP client, by adding automatic retry functionality for failed requests. It helps improve reliability in network operations by retrying requests based on configurable conditions such as error type, status code, or timeout. The plugin supports various retry strategies and backoff mechanisms, making it ideal for applications requiring robust network resilience. It integrates seamlessly with existing Dio setups and works across all major platforms including Android, iOS, Web, macOS, Windows, and Linux.

Use cases

  • Handling transient network failures
  • Improving API call reliability
  • Reducing user frustration from failed requests
  • Supporting offline-first app patterns
  • Automating retry logic for background tasks

Key features

  • Configurable retry conditions
  • Exponential backoff support
  • Retry limit customization
  • Integration with Dio middleware
  • Automatic retry on timeout or connection errors

Suitable for

  • Apps with unreliable network connections
  • API clients needing fault tolerance
  • Background data sync services
  • Real-time data fetching applications
  • Developers using Dio for HTTP operations

Considerations

  • May increase latency if retries are too frequent
  • Requires careful configuration to avoid infinite loops
  • Not suitable for idempotent-only operations
  • Can impact battery life on mobile devices
  • Needs testing under simulated network failure scenarios

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

dio_retry_plus

A plugin for dio that retries failed requests.

Usage

import 'package:dio_retry_plus/dio_retry_plus.dart';
Basic configuration
final dio = Dio()
  ..interceptors.add(RetryInterceptor());
Global retry options
final dio = Dio()
  ..interceptors.add(RetryInterceptor(
    options: const RetryOptions(
      retries: 3, // Number of retries before a failure
      retryInterval: const Duration(seconds: 1), // Interval between each retry
      retryEvaluator: (error) => error.type != DioErrorType.CANCEL && error.type != DioErrorType.RESPONSE, // Evaluating if a retry is necessary regarding the error. It is a good candidate for updating authentication token in case of a unauthorized error (be careful with concurrency though)
    )
  )
);
Sending a request with options
final response = await dio.get("http://www.flutter.dev", options: Options(
    extra: RetryOptions(
      retryInterval: const Duration(seconds: 10),
    ).toExtra(),
  ));
Sending a request without retry
final response = await dio.get("http://www.flutter.dev", options: Options(
    extra: RetryOptions.noRetry().toExtra(),
  ));
Logging retry operations
final dio = Dio()
  ..interceptors.add(RetryInterceptor(logger: Logger("Retry")));

Features and bugs

Please file issues.

Categories

HTTP Client & UtilitiesDio

Dependencies

Dependency list 1 items

Source repository

Projects using this package

No data available yet.