cubitCatch method

Future<void> cubitCatch({
  1. required Future<void> actions(),
  2. bool isLoading = true,
  3. String keyLoading = LoadingKey.global,
  4. Future<void> onError(
    1. Object error,
    2. StackTrace stackTrace
    )?,
  5. Future<void> onFinally()?,
})

Executes a given asynchronous action within a try-catch block, handling loading states.

This method provides a convenient way to perform asynchronous operations while automatically managing loading states and error handling.

Parameters:

  • actions: A required function that contains the asynchronous operations to be performed.
  • isLoading: An optional boolean that determines whether to show/hide loading indicators. Defaults to true.

Usage:

await cubitCatch(
  actions: () async {
    // Perform some asynchronous operations
    await fetchData();
    await processData();
  },
  isLoading: true, // Optional, defaults to true
);

The method will:

  1. Show a loading indicator if isLoading is true.
  2. Execute the provided actions.
  3. Hide the loading indicator after actions complete or if an error occurs.
  4. Log any errors that occur during execution.

Note: This method uses showLoading and hideLoading internally, which should be implemented in the concrete Bloc class or a mixin.

Implementation

Future<void> cubitCatch({
  required Future<void> Function() actions,
  bool isLoading = true,
  String keyLoading = LoadingKey.global,
  Future<void> Function(Object error, StackTrace stackTrace)? onError,
  Future<void> Function()? onFinally,
}) async {
  await catchError(
    actions: actions,
    isLoading: isLoading,
    keyLoading: keyLoading,
    onError: onError,
    onFinally: onFinally,
  );
}