maybeInvoke<T extends Intent> static method Null safety

Object? maybeInvoke<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. If no action mapping was found for the specified intent, or if the first action found was disabled, or the action itself returns null from Action.invoke, then this method returns null.

The context and intent arguments must not be null.

If the given intent doesn't map to an action, then it will look to the next ancestor Actions widget in the hierarchy until it reaches the root. If a suitable Action is found but its Action.isEnabled returns false, the search will stop and this method will return null.

Implementation

static Object? maybeInvoke<T extends Intent>(
  BuildContext context,
  T intent,
) {
  assert(intent != null);
  assert(context != null);
  Object? returnValue;

  _visitActionsAncestors(context, (InheritedElement element) {
    final _ActionsMarker actions = element.widget as _ActionsMarker;
    final Action<T>? result = _castAction(actions, intent: intent);
    if (result != null && result.isEnabled(intent)) {
      // Invoke the action we found using the relevant dispatcher from the Actions
      // Element we found.
      returnValue = _findDispatcher(element).invokeAction(result, intent, context);
    }
    return result != null;
  });
  return returnValue;
}