via method
- FutureOr<
void> action(- EffectVia via,
- EffectScope scope
- bool guard(
- EffectVia via
- void onUncaughtError(
- Object error,
- StackTrace stackTrace
Creates an explicit dynamic discovery Effect using EffectVia and EffectScope.
Schedules an initial evaluation on the microtask scheduler upon activation to discover
dynamic dependencies via via(node), providing an EffectScope to register turn
teardowns and observe lifecycle state.
Prior to subsequent evaluations or deactivation, the previous turn's EffectScope is disposed (marked no longer current) and its registered cleanups are executed in LIFO order.
-
Supports both synchronous and asynchronous (
async)actionclosures: whenactionreturns a Future, dependencies accessed viavia(node)afterawaitpoints are tracked for the latest active turn while superseded turns are isolated automatically. -
If
guardis provided, it is evaluated with EffectVia before each run; returningfalseskips execution. -
If
onUncaughtErroris provided, it is invoked when an uncaught synchronous or asynchronous exception occurs. -
action: The dynamic tracking callback receiving EffectVia and EffectScope. -
guard: Optional boolean predicate evaluated with EffectVia prior to each execution. -
onUncaughtError: Optional error recovery handler.
Ensures:
- Returns a dynamic Effect with explicit EffectVia edge tracking and EffectScope lifecycle.
Examples
final e = Effect.scoped.via((via, scope) {
final endpoint = via(apiEndpoint.bloom);
final client = HttpClient(endpoint);
scope.onCleanup(client.close);
});
Implementation
@pragma('vm:prefer-inline')
Effect via(
FutureOr<void> Function(EffectVia via, EffectScope scope) action, {
bool Function(EffectVia via)? guard,
void Function(Object error, StackTrace stackTrace)? onUncaughtError,
}) =>
_HandledViaEffect(
action,
guard: guard,
onUncaughtError: onUncaughtError,
);