error

open fun error(errorBuilder: RequestBuilder<TranscodeType>): RequestBuilder<TranscodeType>

Sets a RequestBuilder that is built and run if the load started by this fails.

If this RequestBuilder uses a thumbnail that succeeds the given error will be started anyway if the non-thumbnail request fails.

Recursive calls to this method as well as calls to thumbnail and thumbnail are supported for the given error RequestBuilder.

Unlike thumbnail and thumbnail, no options from this primary RequestBuilder are propagated to the given error RequestBuilder. Options like priority, override widths and heights and transitions must be applied independently to the error builder.

The given RequestBuilder will start and potentially override a fallback drawable if it's set on this RequestBuilder via fallback or fallback.

Return

This RequestBuilder.


open fun error(model: Any): RequestBuilder<TranscodeType>

Identical to calling error where the RequestBuilder is the result of calling clone and removing any existing thumbnail and error RequestBuilders.

Other than thumbnail and error RequestBuilders, which are removed, all other options are retained from the primary request. However, order matters! Any options applied after this method is called will not be applied to the error RequestBuilder.

WARNING: Calling this method with a model whose type does not match the type of the model passed to load() may be dangerous! Any options that were applied by the various type specific load() methods, like load will be copied to the error request here even if the model you pass to this method doesn't match. Similary, options that would be normally applied by type specific load() methods will not be applied to this request. If this behavior is confusing or unexpected, use error instead.