NetworkImageWithRetry class

An ImageProvider that fetches the image at url over the network and retries transient failures according to a fetchStrategy.

Drop-in replacement for NetworkImageWithRetry from the discontinued flutter_image package: same constructor shape, same default strategy behavior (exponential backoff with jitter, transient status codes only).

const Image(image: NetworkImageWithRetry('https://example.com/photo.png'))
Inheritance

Constructors

NetworkImageWithRetry(String url, {double scale = 1.0, FetchStrategy fetchStrategy = defaultFetchStrategy, Map<String, String>? headers, Client? client})
Creates a retrying network image provider.
const

Properties

client → Client?
Optional injectable HTTP client. Defaults to a shared http.Client.
final
fetchStrategy → FetchStrategy
The strategy used to fetch the url and retry on failure.
final
hashCode → int
The hash code for this object.
no setteroverride
headers → Map<String, String>?
HTTP headers applied to the request (e.g. Authorization).
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
scale → double
The scale to place in the ImageInfo of the decoded image.
final
url → String
The URL from which the image will be fetched.
final

Methods

createStream(ImageConfiguration configuration) → ImageStream
Called by resolve to create the ImageStream it returns.
inherited
evict({ImageCache? cache, ImageConfiguration configuration = ImageConfiguration.empty}) → Future<bool>
Evicts an entry from the image cache.
inherited
loadBuffer(NetworkImageWithRetry key, DecoderBufferCallback decode) → ImageStreamCompleter
Converts a key into an ImageStreamCompleter, and begins fetching the image.
inherited
loadImage(NetworkImageWithRetry key, ImageDecoderCallback decode) → ImageStreamCompleter
Converts a key into an ImageStreamCompleter, and begins fetching the image.
override
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
obtainCacheStatus({required ImageConfiguration configuration, ImageErrorListener? handleError}) → Future<ImageCacheStatus?>
Returns the cache location for the key that this ImageProvider creates.
inherited
obtainKey(ImageConfiguration configuration) → Future<NetworkImageWithRetry>
Converts an ImageProvider's settings plus an ImageConfiguration to a key that describes the precise image to load.
override
resolve(ImageConfiguration configuration) → ImageStream
Resolves this image provider using the given configuration, returning an ImageStream.
inherited
resolveStreamForKey(ImageConfiguration configuration, ImageStream stream, NetworkImageWithRetry key, ImageErrorListener handleError) → void
Called by resolve with the key returned by obtainKey.
inherited
toString() → String
A string representation of this object.
override

Operators

operator ==(Object other) → bool
The equality operator.
override

Static Methods

defaultFetchStrategy(Uri uri, FetchFailure? failure) → Future<FetchInstructions?>
The default strategy: 3 attempts, exponential backoff (starting at 100 ms, ×1.5 each retry, ±25% jitter), transient status codes only.