invoke<T extends Intent> method Null safety

Object? invoke<T extends Intent>(
  1. BuildContext context,
  2. T intent
)

Invokes the action associated with the given Intent using the Actions widget that most tightly encloses the given BuildContext.

This method returns the result of invoking the action's Action.invoke method.

The context and intent arguments must not be null.

If the given intent doesn't map to an action, or doesn't map to one that returns true for Action.isEnabled in an Actions.actions map it finds, then it will look to the next ancestor Actions widget in the hierarchy until it reaches the root.

This method will throw an exception if no ambient Actions widget is found, or if the given intent doesn't map to an enabled action in any of the Actions.actions maps that are found.

Implementation

static Object? invoke<T extends Intent>(
  BuildContext context,
  T intent,
) {
  assert(intent != null);
  assert(context != null);
  Action<T>? action;
  InheritedElement? actionElement;

  _visitActionsAncestors(context, (InheritedElement element) {
    final _ActionsMarker actions = element.widget as _ActionsMarker;
    final Action<T>? result = actions.actions[intent.runtimeType] as Action<T>?;
    if (result != null) {
      actionElement = element;
      if (result.isEnabled(intent)) {
        action = result;
        return true;
      }
    }
    return false;
  });

  assert(() {
    if (actionElement == null) {
      throw FlutterError(
        'Unable to find an action for an Intent with type '
        '${intent.runtimeType} in an $Actions widget in the given context.\n'
        '$Actions.invoke() was unable to find an $Actions widget that '
        "contained a mapping for the given intent, or the intent type isn't the "
        'same as the type argument to invoke (which is $T - try supplying a '
        'type argument to invoke if one was not given)\n'
        'The context used was:\n'
        '  $context\n'
        'The intent type requested was:\n'
        '  ${intent.runtimeType}',
      );
    }
    return true;
  }());
  if (actionElement == null || action == null) {
    return null;
  }
  // Invoke the action we found using the relevant dispatcher from the Actions
  // Element we found.
  return _findDispatcher(actionElement!).invokeAction(action!, intent, context);
}