retry 3.1.2 copy "retry: ^3.1.2" to clipboard
retry: ^3.1.2 copied to clipboard

Utility for wrapping an asynchronous function in automatic retry logic with exponential back-off, useful when making requests over network.

Retry for dart #

This package provides an easy way to retry asynchronous functions. This is often useful to avoid crashing on intermittent errors such as broken connections or temporarily overloaded servers.

Disclaimer: This is not an officially supported Google product.

Using retry #

For simple retry logic with exponential back-off use the retry function provided by this package.

import 'package:retry/retry.dart';

final response = await retry(
  // Make a GET request
  () => http.get('https://google.com').timeout(Duration(seconds: 5)),
  // Retry on SocketException or TimeoutException
  retryIf: (e) => e is SocketException || e is TimeoutException,
);
print(response.body);

Defaults to 8 attempts, sleeping as following after 1st, 2nd, 3rd, ..., 7th attempt:

  1. 400 ms +/- 25%
  2. 800 ms +/- 25%
  3. 1600 ms +/- 25%
  4. 3200 ms +/- 25%
  5. 6400 ms +/- 25%
  6. 12800 ms +/- 25%
  7. 25600 ms +/- 25%

Using RetryOptions #

This package provides RetryOptions which defined how many times to retry an function and how long to sleep between retries.

final r = RetryOptions(maxAttempts: 8);
final response = await r.retry(
  // Make a GET request
  () => http.get('https://google.com').timeout(Duration(seconds: 5)),
  // Retry on SocketException or TimeoutException
  retryIf: (e) => e is SocketException || e is TimeoutException,
);
print(response.body);
774
likes
140
pub points
99%
popularity

Publisher

verified publishergoogle.dev

Utility for wrapping an asynchronous function in automatic retry logic with exponential back-off, useful when making requests over network.

Homepage
Repository (GitHub)
View/report issues
Contributing

Topics

#network #http

Documentation

API reference

License

Apache-2.0 (LICENSE)

More

Packages that depend on retry