# When a route is removed from the stack, associated futures must complete

> Before this breaking change, routes created by Navigator and awaited for results could never complete if the route was removed instead of popped.




:::important
These breaking change docs are accurate, as of the release
under which they are published. Over time, the
workarounds described here might become inaccurate.
We don't, in general, keep these breaking change docs up
to date as of each release.

The [breaking change index file](/release/breaking-changes)
lists the docs created for each release.
:::


## Summary

When routes are pushed, developers can await them to be notified when they are
popped. However, this didn't work when they were removed because the associated
future was never completed.

## Context

All Navigator methods that call `remove` had this issue. By using `complete`,
the issue is properly resolved, allowing developers to pass a result.

## Description of change

All Navigator methods have been updated to no longer call `remove` but instead
use `complete`. Context menus are now built from the `contextMenuBuilder`
parameter.

All methods that directly use `complete` now accept an optional `result`
parameter to return it to the associated future. Other methods that indirectly
use `remove` currently return `null`. In the future, we might extend these
methods with an optional callback function to allow developers to handle pop
logic in indirect scenarios (such as `removeUntil`).

Before this PR, the methods below can't return a result:

```dart
Navigator.of(context).removeRoute(route);
Navigator.of(context).removeRouteBelow(route);
```

After this PR, methods can return a result:

```dart
Navigator.of(context).removeRoute(route, result);
Navigator.of(context).removeRouteBelow(route, result);
```

## Migration guide

If you implemented `RouteTransitionRecord` and used `markForRemove`,
you need to use `markForComplete` instead. `markForRemove` is now deprecated.

For other developers, no changes are required. The navigator continues to work
as expected with new capabilities.

## Timeline

Landed in version: 3.31.0-0.0.pre<br>
In stable release: 3.32

## References

### API documentation:

* [`RouteTransitionRecord`](https://api.flutter.dev/flutter/widgets/RouteTransitionRecord-class.html)
* [`Navigator`](https://api.flutter.dev/flutter/widgets/Navigator-class.html)

### Relevant issues:

* [removeRoute unresolved future](https://github.com/flutter/flutter/issues/157505)

### Relevant PRs:

* [feat: removeRoute now calls didComplete](https://github.com/flutter/flutter/pull/157725)