[go_router] Allow users to specify onExit as optional

[hantrungkien]

Related to flutter/flutter#183099

Allow users to specify onExit as optional

Pre-Review Checklist

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
• I read the Tree Hygiene page, which explains my responsibilities.
• I read and followed the relevant style guides and ran the auto-formatter.
• I signed the CLA.
• The title of the PR starts with the name of the package surrounded by square brackets, e.g. [shared_preferences]
• I linked to at least one issue that this PR fixes in the description above.
• I followed the version and CHANGELOG instructions, using semantic versioning and the repository CHANGELOG style, or I have commented below to indicate which documented exception this PR falls under¹.
• I updated/added any relevant documentation (doc comments with ///).
• I added new tests to check the change I am making, or I have commented below to indicate which test exemption this PR falls under¹.
• All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel on Discord.

Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the gemini-code-assist bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.

Footnotes

1. Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling. ↩ ↩²

[flutter-dashboard]

It looks like this pull request may not have tests. Please make sure to add tests or get an explicit test exemption before merging.

If you are not sure if you need tests, consider this rule of thumb: the purpose of a test is to make sure someone doesn't accidentally revert the fix. Ask yourself, is there anything in your PR that you feel it is important we not accidentally revert back to how it was before your fix?

Reviewers: Read the Tree Hygiene page and make sure this patch meets those guidelines before LGTMing. If you believe this PR qualifies for a test exemption, contact "@test-exemption-reviewer" in the #hackers channel in Discord (don't just cc them here, they won't see it!). The test exemption team is a small volunteer group, so all reviewers should feel empowered to ask for tests, without delegating that responsibility entirely to the test exemption group.

[google-cla]

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

[gemini-code-assist]

Code Review

This pull request introduces an overrideOnExit parameter to TypedGoRoute and TypedRelativeGoRoute. This parameter controls whether the onExit method on the corresponding route data class is invoked. The default is false, which changes the previous behavior where onExit was always called. My review identifies this as a breaking change that should be handled according to semantic versioning. I've also noted the lack of tests for the new functionality and suggested improvements to the naming and documentation for clarity.

[hantrungkien]

go_router_builder PR: #11151

[stuartmorgan-g]

Thanks for the contribution! You’ve checked boxes in the PR checklist above that are not reflected in this PR, so I’m assuming this is a work in progress and am marking it as a Draft. Please review the checklist, updating the PR as appropriate, and when the state of the PR as posted reflects the checklist please feel free to mark it as ready for review.

• I added new tests to check the change I am making, or I have commented below to indicate which test exemption this PR falls under1.
• All existing and new tests are passing.

[hantrungkien]

@stuartmorgan-g Thank you for your quick response. I’ve added the missing items. Please take a look and review them for me!

[gemini-code-assist]

Code Review

This pull request introduces the overrideOnExit parameter to TypedGoRoute and TypedRelativeGoRoute, allowing users to explicitly control whether the onExit method of route data classes is invoked. The onExit callback in _GoRouteParameters has been made optional to support this. The changes include updates to the CHANGELOG.md and pubspec.yaml files, along with comprehensive test cases for the new functionality. The implementation is clear, well-documented, and correctly tested, adhering to the repository's coding standards.

[chunhtai]

This may be a breaking change for older version of go router builder because this will always be false and onExit will break. will need to come up with a different way or a migration guide

[hantrungkien]

@chunhtai I have updated hasOverriddenOnExit to have a default value of null for backward compatibility with older versions of go_router_builder. Please review it for me!

[chunhtai]

also ci is red

[hantrungkien]

also ci is red

@chunhtai I ran all tests for go_router and go_router_builder locally (including the example), and they all passed. Could a maintainer please take a look or trigger a re-run?