diff --git a/CHANGELOG.md b/CHANGELOG.md
index f017d422729..cf6be27ea7a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,18 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [9.0.7](https://github.com/ionic-team/ionic-framework/compare/v9.0.6...v9.0.7) (2026-10-07)
+
+### Bug Fixes
+
+* **close-watcher:** allow back navigation when nothing is open ([#31520](https://github.com/ionic-team/ionic-framework/issues/31520)) ([6532bcb](https://github.com/ionic-team/ionic-framework/commit/6532bcbcf5b69f33724a66ab76720ec645adb00b)), closes [#29648](https://github.com/ionic-team/ionic-framework/issues/29648)
+* **css:** stop emitting :host-context selectors in global stylesheets ([#31516](https://github.com/ionic-team/ionic-framework/issues/31516)) ([35bd2fa](https://github.com/ionic-team/ionic-framework/commit/35bd2fa9f1046b3f5fd3cd6b3778b0b5945be99c)), closes [#30024](https://github.com/ionic-team/ionic-framework/issues/30024)
+* **input-otp:** sync value when length changes ([#31485](https://github.com/ionic-team/ionic-framework/issues/31485)) ([e425825](https://github.com/ionic-team/ionic-framework/commit/e425825815d3c0ab39800912558624b9de72dc6f)), closes [#31484](https://github.com/ionic-team/ionic-framework/issues/31484) [#31484](https://github.com/ionic-team/ionic-framework/issues/31484)
+* **react:** prevent error when an outlet unmounts before it's ready ([#31517](https://github.com/ionic-team/ionic-framework/issues/31517)) ([d5bab2e](https://github.com/ionic-team/ionic-framework/commit/d5bab2e89548311b2e3f62b5fe2be477685cb06d)), closes [#31513](https://github.com/ionic-team/ionic-framework/issues/31513)
+* **vue-router:** render the redirect target when a guard redirects ([#31510](https://github.com/ionic-team/ionic-framework/issues/31510)) ([643584b](https://github.com/ionic-team/ionic-framework/commit/643584b3ac2ba1ca263cbf53960ccde3be2a96fc))
+* **vue-router:** reset tab with memory history ([#31511](https://github.com/ionic-team/ionic-framework/issues/31511)) ([edbc304](https://github.com/ionic-team/ionic-framework/commit/edbc304fbc4179a668d0e170241abd78311fdb62)), closes [#29785](https://github.com/ionic-team/ionic-framework/issues/29785)
+
+
## [9.0.6](https://github.com/ionic-team/ionic-framework/compare/v9.0.5...v9.0.6) (2026-09-30)
### Bug Fixes
diff --git a/core/CHANGELOG.md b/core/CHANGELOG.md
index 7532826ba38..531652cf2e3 100644
--- a/core/CHANGELOG.md
+++ b/core/CHANGELOG.md
@@ -3,6 +3,15 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [9.0.7](https://github.com/ionic-team/ionic-framework/compare/v9.0.6...v9.0.7) (2026-10-07)
+
+### Bug Fixes
+
+* **close-watcher:** allow back navigation when nothing is open ([#31520](https://github.com/ionic-team/ionic-framework/issues/31520)) ([6532bcb](https://github.com/ionic-team/ionic-framework/commit/6532bcbcf5b69f33724a66ab76720ec645adb00b)), closes [#29648](https://github.com/ionic-team/ionic-framework/issues/29648)
+* **css:** stop emitting :host-context selectors in global stylesheets ([#31516](https://github.com/ionic-team/ionic-framework/issues/31516)) ([35bd2fa](https://github.com/ionic-team/ionic-framework/commit/35bd2fa9f1046b3f5fd3cd6b3778b0b5945be99c)), closes [#30024](https://github.com/ionic-team/ionic-framework/issues/30024)
+* **input-otp:** sync value when length changes ([#31485](https://github.com/ionic-team/ionic-framework/issues/31485)) ([e425825](https://github.com/ionic-team/ionic-framework/commit/e425825815d3c0ab39800912558624b9de72dc6f)), closes [#31484](https://github.com/ionic-team/ionic-framework/issues/31484) [#31484](https://github.com/ionic-team/ionic-framework/issues/31484)
+
+
## [9.0.6](https://github.com/ionic-team/ionic-framework/compare/v9.0.5...v9.0.6) (2026-09-30)
**Note:** Version bump only for package @ionic/core
diff --git a/core/package-lock.json b/core/package-lock.json
index c07eb94a9e5..a8585f40530 100644
--- a/core/package-lock.json
+++ b/core/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@ionic/core",
- "version": "9.0.6",
+ "version": "9.0.7",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@ionic/core",
- "version": "9.0.6",
+ "version": "9.0.7",
"license": "MIT",
"dependencies": {
"@stencil/core": "^4.44.2",
@@ -653,9 +653,9 @@
}
},
"node_modules/@capacitor/keyboard": {
- "version": "8.0.5",
- "resolved": "https://registry.npmjs.org/@capacitor/keyboard/-/keyboard-8.0.5.tgz",
- "integrity": "sha512-oFXygC4eKYA5l2MdpTR06L2M/4x6e2SLD5yS1T9+UBDKTkzyvhWKEhbYLUaTIBPpLKqlfGudJw1X73S1H9eUzQ==",
+ "version": "8.0.6",
+ "resolved": "https://registry.npmjs.org/@capacitor/keyboard/-/keyboard-8.0.6.tgz",
+ "integrity": "sha512-Bbe+9V0qaT6dzEFJEK7BUWR01l2+vZE8FM5ITF/WgKtx+G6eGZ6d5+YiSMRJBAK0VGjdO59v8yiQ10Doa5KyvQ==",
"dev": true,
"license": "MIT",
"peerDependencies": {
@@ -663,9 +663,9 @@
}
},
"node_modules/@capacitor/status-bar": {
- "version": "8.0.3",
- "resolved": "https://registry.npmjs.org/@capacitor/status-bar/-/status-bar-8.0.3.tgz",
- "integrity": "sha512-csSpfNeN49Hx9JaQBSJEIiEbOLtXg3kcc2IpScq2fu5L520h3AWEvsxoH8Srk1jxfRKepaJ4S4sqSC3foI4AgA==",
+ "version": "8.0.4",
+ "resolved": "https://registry.npmjs.org/@capacitor/status-bar/-/status-bar-8.0.4.tgz",
+ "integrity": "sha512-ZMzBUyHBzwDUxcHadEhvOvmoPmMQGMZgaMRJu8ohELeI6IaxoVH9ZhdF/OHnY3/yykv3Glev8Tnbh4aZY/0B0w==",
"dev": true,
"license": "MIT",
"peerDependencies": {
@@ -1839,9 +1839,9 @@
}
},
"node_modules/@stencil/core": {
- "version": "4.45.1",
- "resolved": "https://registry.npmjs.org/@stencil/core/-/core-4.45.1.tgz",
- "integrity": "sha512-/b8CItmSwOzZwafxXwomJnN9X/Ic/Fxum9ka/RDHmADVf4DA4152uY7zitzLV+vk8JdXxKA7FKyLT3GKNo9R3A==",
+ "version": "4.45.2",
+ "resolved": "https://registry.npmjs.org/@stencil/core/-/core-4.45.2.tgz",
+ "integrity": "sha512-CNkPVZsqyNMjFMX9bEkMJsvBbQxjLw480OaoamoqiLPdQCFjJQReeOjnWX1A5ivSn3UYEIJ6MoN5VXDkaHGt8Q==",
"license": "MIT",
"bin": {
"stencil": "bin/stencil"
diff --git a/core/package.json b/core/package.json
index 9e43d9b115f..6c255150c0f 100644
--- a/core/package.json
+++ b/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@ionic/core",
- "version": "9.0.6",
+ "version": "9.0.7",
"description": "Base components for Ionic",
"engines": {
"node": ">= 16"
diff --git a/core/src/components/input-otp/input-otp.tsx b/core/src/components/input-otp/input-otp.tsx
index 7c46ca59d42..1c84b3c9a42 100644
--- a/core/src/components/input-otp/input-otp.tsx
+++ b/core/src/components/input-otp/input-otp.tsx
@@ -43,6 +43,12 @@ export class InputOTP implements ComponentInterface {
*/
private isKeyboardNavigation = false;
+ /**
+ * The `length` watcher runs before new inputs render, so
+ * `componentDidRender` updates their tab indexes instead.
+ */
+ private updateTabIndexesAfterRender = false;
+
@Element() el!: HTMLIonInputOtpElement;
@State() private inputValues: string[] = [];
@@ -197,6 +203,12 @@ export class InputOTP implements ComponentInterface {
this.updateTabIndexes();
}
+ @Watch('length')
+ lengthChanged() {
+ this.initializeValues();
+ this.updateTabIndexesAfterRender = true;
+ }
+
/**
* Processes the separators prop into an array of numbers.
*
@@ -272,6 +284,13 @@ export class InputOTP implements ComponentInterface {
this.updateTabIndexes();
}
+ componentDidRender() {
+ if (this.updateTabIndexesAfterRender) {
+ this.updateTabIndexesAfterRender = false;
+ this.updateTabIndexes();
+ }
+ }
+
/**
* Get the regex pattern for allowed characters.
* If a pattern is provided, use it to create a regex pattern
@@ -851,7 +870,14 @@ export class InputOTP implements ComponentInterface {
tabIndex={index === tabbableIndex ? 0 : -1}
value={inputValues[index] || ''}
autocomplete="one-time-code"
- ref={(el) => (inputRefs[index] = el as HTMLInputElement)}
+ ref={(el) => {
+ if (el) {
+ inputRefs[index] = el as HTMLInputElement;
+ } else {
+ // The input was removed, so drop its ref and any after it.
+ inputRefs.splice(index);
+ }
+ }}
onInput={this.onInput(index)}
onBlur={this.onBlur}
onFocus={this.onFocus(index)}
diff --git a/core/src/components/input-otp/test/a11y/input-otp.e2e.ts b/core/src/components/input-otp/test/a11y/input-otp.e2e.ts
index 88b0be04800..7cc5374d8ef 100644
--- a/core/src/components/input-otp/test/a11y/input-otp.e2e.ts
+++ b/core/src/components/input-otp/test/a11y/input-otp.e2e.ts
@@ -46,6 +46,27 @@ configs().forEach(({ title, config }) => {
await expect(inputBoxes.nth(3)).toHaveAttribute('aria-hidden', 'true');
});
+ test('should update aria-hidden when length increases', async ({ page }, testInfo) => {
+ testInfo.annotations.push({
+ type: 'issue',
+ description: 'https://github.com/ionic-team/ionic-framework/issues/31484',
+ });
+
+ await page.setContent(``, config);
+
+ const inputOtp = page.locator('ion-input-otp');
+ await inputOtp.evaluate((el: HTMLIonInputOtpElement) => {
+ el.length = 4;
+ });
+
+ const inputBoxes = page.locator('ion-input-otp input');
+
+ await expect(inputBoxes.nth(0)).toHaveAttribute('aria-hidden', 'false');
+ await expect(inputBoxes.nth(1)).toHaveAttribute('aria-hidden', 'true');
+ await expect(inputBoxes.nth(2)).toHaveAttribute('aria-hidden', 'true');
+ await expect(inputBoxes.nth(3)).toHaveAttribute('aria-hidden', 'true');
+ });
+
test('should update aria-hidden when typing a value', async ({ page }) => {
await page.setContent(``, config);
diff --git a/core/src/components/input-otp/test/basic/input-otp.e2e.ts b/core/src/components/input-otp/test/basic/input-otp.e2e.ts
index 306e72f873d..a135f502f0a 100644
--- a/core/src/components/input-otp/test/basic/input-otp.e2e.ts
+++ b/core/src/components/input-otp/test/basic/input-otp.e2e.ts
@@ -71,6 +71,39 @@ configs({ modes: ['ios'] }).forEach(({ title, config }) => {
await verifyInputValues(inputOtp, ['1', '2', '3', '4', '5', '6', '7', '8']);
});
+ test('should synchronize the value when length changes', async ({ page }, testInfo) => {
+ testInfo.annotations.push({
+ type: 'issue',
+ description: 'https://github.com/ionic-team/ionic-framework/issues/31484',
+ });
+
+ await page.setContent(`Description`, config);
+
+ const inputOtp = page.locator('ion-input-otp');
+ await inputOtp.evaluate((el) => el.setAttribute('length', '2'));
+
+ await verifyInputValues(inputOtp, ['1', '2']);
+ });
+
+ test('should add empty input boxes when length increases', async ({ page }, testInfo) => {
+ testInfo.annotations.push({
+ type: 'issue',
+ description: 'https://github.com/ionic-team/ionic-framework/issues/31484',
+ });
+
+ await page.setContent(`Description`, config);
+
+ const inputOtp = page.locator('ion-input-otp');
+ await inputOtp.evaluate((el: HTMLIonInputOtpElement) => {
+ el.length = 4;
+ });
+
+ const inputBoxes = page.locator('ion-input-otp input');
+ await expect(inputBoxes).toHaveCount(4);
+
+ await verifyInputValues(inputOtp, ['1', '2', '', '']);
+ });
+
test('should accept numbers only by default', async ({ page }) => {
await page.setContent(`Description`, config);
@@ -1033,6 +1066,36 @@ configs({ modes: ['ios'], directions: ['ltr'] }).forEach(({ title, config }) =>
await expect(ionChange).toHaveReceivedEventTimes(1);
});
+ test('should emit ionChange event when blurring with a new value after length decreases', async ({
+ page,
+ }, testInfo) => {
+ testInfo.annotations.push({
+ type: 'issue',
+ description: 'https://github.com/ionic-team/ionic-framework/issues/31484',
+ });
+
+ await page.setContent(`Description`, config);
+
+ const ionChange = await page.spyOnEvent('ionChange');
+
+ const inputOtp = page.locator('ion-input-otp');
+ await inputOtp.evaluate((el: HTMLIonInputOtpElement) => {
+ el.length = 2;
+ });
+ await page.waitForChanges();
+
+ const firstInput = page.locator('ion-input-otp input').first();
+ await firstInput.focus();
+
+ await page.keyboard.type('12');
+
+ // Click outside the input to trigger the blur event
+ await page.mouse.click(0, 0);
+
+ await ionChange.next();
+ await expect(ionChange).toHaveReceivedEventDetail({ value: '12', event: { isTrusted: true } });
+ });
+
test('should not emit ionChange event when blurring with the same value', async ({ page }) => {
await page.setContent(`Description`, config);
diff --git a/core/src/components/menu/menu.tsx b/core/src/components/menu/menu.tsx
index 4bf4564c40f..d9749f75b21 100644
--- a/core/src/components/menu/menu.tsx
+++ b/core/src/components/menu/menu.tsx
@@ -3,7 +3,7 @@ import { Build, Component, Element, Event, Host, Listen, Method, Prop, State, Wa
import { getTimeGivenProgression } from '@utils/animation/cubic-bezier';
import { focusFirstDescendant, focusLastDescendant } from '@utils/focus-trap';
import { GESTURE_CONTROLLER } from '@utils/gesture';
-import { shouldUseCloseWatcher } from '@utils/hardware-back-button';
+import { shouldUseCloseWatcher, updateCloseWatcher } from '@utils/hardware-back-button';
import type { Attributes } from '@utils/helpers';
import { inheritAriaAttributes, assert, clamp, isEndSide as isEnd } from '@utils/helpers';
import { printIonError } from '@utils/logging';
@@ -726,6 +726,7 @@ export class Menu implements ComponentInterface, MenuI {
// emit opened/closed events
this._isOpen = isOpen;
this.isAnimating = false;
+ updateCloseWatcher();
if (!this._isOpen) {
this.blocker.unblock();
}
diff --git a/core/src/components/menu/test/close-watcher/menu.e2e.ts b/core/src/components/menu/test/close-watcher/menu.e2e.ts
new file mode 100644
index 00000000000..d77b89c5eeb
--- /dev/null
+++ b/core/src/components/menu/test/close-watcher/menu.e2e.ts
@@ -0,0 +1,71 @@
+import { expect } from '@playwright/test';
+import { configs, test } from '@utils/test/playwright';
+
+/**
+ * This behavior does not vary across modes/directions
+ */
+configs({ modes: ['ios'], directions: ['ltr'] }).forEach(({ title, config }) => {
+ test.describe(title('menu: close watcher'), () => {
+ test('should close the menu on a close request and release the back button', async ({ page, skip }, testInfo) => {
+ testInfo.annotations.push({
+ type: 'issue',
+ description: 'https://github.com/ionic-team/ionic-framework/issues/29648',
+ });
+ skip.browser((browserName: string) => browserName !== 'chromium', 'Only Chromium supports the CloseWatcher API');
+
+ await page.setContent(
+ `
+
+
+
+ Menu Content
+
+
+ Main Content
+
+
+ `,
+ config
+ );
+
+ const menu = page.locator('ion-menu');
+ const ionDidOpen = await page.spyOnEvent('ionDidOpen');
+ const ionDidClose = await page.spyOnEvent('ionDidClose');
+
+ await menu.evaluate((el: HTMLIonMenuElement) => el.open());
+ await ionDidOpen.next();
+ expect(await page.evaluate(() => (window as any).liveCloseWatchers)).toBe(1);
+
+ // Escape sends a close request to the active CloseWatcher
+ await page.keyboard.press('Escape');
+
+ await ionDidClose.next();
+ await expect(menu).not.toHaveClass(/show-menu/);
+ expect(await page.evaluate(() => (window as any).liveCloseWatchers)).toBe(0);
+ });
+ });
+});
diff --git a/core/src/css/float-elements.scss b/core/src/css/float-elements.scss
index 0e543e3404e..78147a3798a 100644
--- a/core/src/css/float-elements.scss
+++ b/core/src/css/float-elements.scss
@@ -1,3 +1,6 @@
+// Global stylesheet: `:host-context()` never matches outside a shadow root
+$rtl-use-host-context: false;
+
@import "../themes/ionic.globals";
@import "../themes/ionic.mixins";
diff --git a/core/src/css/test/global-stylesheets.spec.ts b/core/src/css/test/global-stylesheets.spec.ts
new file mode 100644
index 00000000000..430e3702de1
--- /dev/null
+++ b/core/src/css/test/global-stylesheets.spec.ts
@@ -0,0 +1,38 @@
+import { execFileSync } from 'child_process';
+import { readdirSync } from 'fs';
+import { dirname, join } from 'path';
+
+const cssDir = join(__dirname, '..');
+const sassCli = join(dirname(require.resolve('sass')), 'sass.js');
+
+/**
+ * Compiles through the sass CLI, the same way `npm run css.sass` builds
+ * the published stylesheets. The sass JS API can't be imported here
+ * because it detects the spec window and never populates its exports.
+ */
+const compileStylesheet = (file: string) =>
+ execFileSync(process.execPath, [sassCli, '--style=compressed', '--no-source-map', join(cssDir, file)], {
+ encoding: 'utf8',
+ });
+
+const globalStylesheets = ['.', 'palettes'].flatMap((dir) =>
+ readdirSync(join(cssDir, dir))
+ .filter((file) => file.endsWith('.scss'))
+ .map((file) => join(dir, file))
+);
+
+describe('global stylesheets', () => {
+ // https://github.com/ionic-team/ionic-framework/issues/30024
+ it.each(globalStylesheets)('%s should not contain :host-context', (file) => {
+ expect(compileStylesheet(file)).not.toContain(':host-context');
+ });
+
+ it('float-elements.scss should flip start and end floats for an ancestor dir=rtl', () => {
+ const css = compileStylesheet('float-elements.scss');
+
+ expect(css).toContain('[dir=rtl] .ion-float-start{float:right !important}');
+ expect(css).toContain('[dir=rtl] .ion-float-end{float:left !important}');
+ expect(css).toContain('.ion-float-start:dir(rtl){float:right !important}');
+ expect(css).toContain('.ion-float-end:dir(rtl){float:left !important}');
+ });
+});
diff --git a/core/src/themes/ionic.mixins.scss b/core/src/themes/ionic.mixins.scss
index da174046be7..aa25b62abe6 100644
--- a/core/src/themes/ionic.mixins.scss
+++ b/core/src/themes/ionic.mixins.scss
@@ -226,6 +226,11 @@
// }
}
+// Whether `rtl()` emits `:host-context()` selectors. Global stylesheets
+// set this to false: they apply to the document, where `:host-context()`
+// never matches, and Lightning CSS warns about every occurrence.
+$rtl-use-host-context: true !default;
+
@mixin rtl() {
$root: #{&};
@@ -254,7 +259,7 @@
}
// Supported by Chrome.
- @if length($hostContextSelectors) > 0 {
+ @if $rtl-use-host-context and length($hostContextSelectors) > 0 {
@at-root #{$hostContextSelectors} {
@content;
}
diff --git a/core/src/utils/config.ts b/core/src/utils/config.ts
index cca58752ee7..6a841a3fcf2 100644
--- a/core/src/utils/config.ts
+++ b/core/src/utils/config.ts
@@ -206,7 +206,10 @@ export interface IonicConfig {
/**
* @experimental
* If `true`, the [CloseWatcher API](https://github.com/WICG/close-watcher) will be used to handle
- * all Escape key and hardware back button presses to dismiss menus and overlays and to navigate.
+ * Escape key and Android back button presses that dismiss menus and overlays. It's only active
+ * while a menu or an overlay other than a toast is open, so back navigation works as usual
+ * otherwise. Hybrid apps still handle the hardware back button through the native `backbutton`
+ * event.
* Note that the `hardwareBackButton` config option must also be `true`.
*/
experimentalCloseWatcher?: boolean;
diff --git a/core/src/utils/hardware-back-button.ts b/core/src/utils/hardware-back-button.ts
index 96da99979fb..46b4c19c5c0 100644
--- a/core/src/utils/hardware-back-button.ts
+++ b/core/src/utils/hardware-back-button.ts
@@ -48,6 +48,26 @@ export const blockHardwareBackButton = () => {
document.addEventListener('backbutton', () => {});
};
+const closeWatcherConditions: (() => boolean)[] = [];
+let syncCloseWatcher: (() => void) | undefined;
+
+/**
+ * Registers a check for whether the back button
+ * has something to close. The CloseWatcher is only
+ * active while one of these checks passes.
+ */
+export const addCloseWatcherCondition = (condition: () => boolean) => {
+ closeWatcherConditions.push(condition);
+};
+
+/**
+ * Call this whenever something the back button
+ * can close opens or closes.
+ */
+export const updateCloseWatcher = () => {
+ syncCloseWatcher?.();
+};
+
export const startHardwareBackButton = () => {
const doc = document;
let busy = false;
@@ -105,16 +125,32 @@ export const startHardwareBackButton = () => {
};
/**
- * If the CloseWatcher is defined then
- * we don't want to also listen for the native
- * backbutton event otherwise we may get duplicate
- * events firing.
+ * Android WebView never sends the hardware back
+ * button to a CloseWatcher, so hybrid apps still
+ * need this. Browsers never fire backbutton.
*/
+ doc.addEventListener('backbutton', backButtonCallback);
+
if (shouldUseCloseWatcher()) {
let watcher: CloseWatcher | undefined;
- const configureWatcher = () => {
- watcher?.destroy();
+ /**
+ * An active CloseWatcher stops the back button from
+ * navigating, so only keep one while there's something to close.
+ */
+ syncCloseWatcher = () => {
+ const canClose = closeWatcherConditions.some((condition) => condition());
+
+ if (!canClose) {
+ watcher?.destroy();
+ watcher = undefined;
+ return;
+ }
+
+ if (watcher !== undefined) {
+ return;
+ }
+
watcher = new win!.CloseWatcher!();
/**
@@ -122,17 +158,18 @@ export const startHardwareBackButton = () => {
* the watcher gets destroyed.
* As a result, we need to re-configure
* the watcher so we can respond to other
- * close requests.
+ * close requests, including after one that
+ * closed nothing, like a modal whose canDismiss
+ * returned false.
*/
watcher!.onclose = () => {
+ watcher = undefined;
backButtonCallback();
- configureWatcher();
+ syncCloseWatcher?.();
};
};
- configureWatcher();
- } else {
- doc.addEventListener('backbutton', backButtonCallback);
+ syncCloseWatcher();
}
};
diff --git a/core/src/utils/menu-controller/index.ts b/core/src/utils/menu-controller/index.ts
index 5d170112340..6d90e958e87 100644
--- a/core/src/utils/menu-controller/index.ts
+++ b/core/src/utils/menu-controller/index.ts
@@ -1,6 +1,6 @@
import { doc } from '@utils/browser';
import type { BackButtonEvent } from '@utils/hardware-back-button';
-import { MENU_BACK_BUTTON_PRIORITY } from '@utils/hardware-back-button';
+import { MENU_BACK_BUTTON_PRIORITY, addCloseWatcherCondition } from '@utils/hardware-back-button';
import { printIonWarning } from '@utils/logging';
import type { MenuI, MenuControllerI } from '../../components/menu/menu-interface';
@@ -229,6 +229,7 @@ const createMenuController = (): MenuControllerI => {
registerAnimation('push', menuPushAnimation);
registerAnimation('overlay', menuOverlayAnimation);
+ addCloseWatcherCondition(() => _getOpenSync() !== undefined);
doc?.addEventListener('ionBackButton', (ev: BackButtonEvent) => {
const openMenu = _getOpenSync();
if (openMenu) {
diff --git a/core/src/utils/overlays.ts b/core/src/utils/overlays.ts
index 40bbb7b88fc..7a1dd014bd3 100644
--- a/core/src/utils/overlays.ts
+++ b/core/src/utils/overlays.ts
@@ -1,7 +1,7 @@
import { doc } from '@utils/browser';
import { focusFirstDescendant, focusLastDescendant, focusableQueryString } from '@utils/focus-trap';
import type { BackButtonEvent } from '@utils/hardware-back-button';
-import { shouldUseCloseWatcher } from '@utils/hardware-back-button';
+import { addCloseWatcherCondition, shouldUseCloseWatcher, updateCloseWatcher } from '@utils/hardware-back-button';
import { printIonError, printIonWarning } from '@utils/logging';
import { config } from '../global/config';
@@ -35,6 +35,12 @@ import {
let lastOverlayIndex = 0;
let lastId = 0;
+/**
+ * Every overlay except toast, which doesn't trap
+ * focus or close on back.
+ */
+const NON_TOAST_OVERLAYS = 'ion-alert,ion-action-sheet,ion-loading,ion-modal,ion-popover';
+
export const activeAnimations = new WeakMap();
type OverlayWithFocusTrapProps = HTMLIonOverlayElement & {
@@ -186,7 +192,7 @@ const focusElementInOverlay = (hostToFocus: HTMLElement | null | undefined, over
* Should NOT include: Toast
*/
const trapKeyboardFocus = (ev: Event, doc: Document) => {
- const lastOverlay = getPresentedOverlay(doc, 'ion-alert,ion-action-sheet,ion-loading,ion-modal,ion-popover');
+ const lastOverlay = getPresentedOverlay(doc, NON_TOAST_OVERLAYS);
const target = ev.target as HTMLElement | null;
/**
@@ -383,6 +389,12 @@ const connectListeners = (doc: Document) => {
true
);
+ /**
+ * Whether the overlay actually dismisses is checked at press time,
+ * since `backdropDismiss` can change while it's open.
+ */
+ addCloseWatcherCondition(() => getPresentedOverlay(doc, NON_TOAST_OVERLAYS) !== undefined);
+
// handle back-button click
doc.addEventListener('ionBackButton', (ev) => {
const lastOverlay = getPresentedOverlay(doc);
@@ -525,7 +537,8 @@ export const setRootAriaHidden = (hidden = false) => {
* Cleans up root `aria-hidden` and `backdrop-no-scroll` when
* an overlay is removed from the DOM without going through
* the `dismiss()` flow (e.g., when a framework unmounts the
- * overlay during a route change).
+ * overlay during a route change). Also releases the
+ * CloseWatcher if nothing is left to close.
*
* Should be called from an overlay's `disconnectedCallback`
* when the overlay was still presented at the time of removal.
@@ -535,6 +548,8 @@ export const cleanupRootFocusTrapAccessibility = () => {
return;
}
+ updateCloseWatcher();
+
const remainingOverlays = getPresentedOverlays(document);
const hasRemainingLocking = remainingOverlays.some((o) => locksAppRoot(o as OverlayWithFocusTrapProps));
@@ -559,7 +574,9 @@ const applyRootLock = (el: OverlayWithFocusTrapProps) => {
/**
* Re-applies the root lock that `cleanupRootFocusTrapAccessibility()` released.
- * Call from `connectedCallback` when the overlay is still presented.
+ * Call from `connectedCallback` when the overlay is still presented. Also
+ * re-arms the CloseWatcher, which every overlay needs, so that happens
+ * before the `locksAppRoot` check.
*
* A synchronous move keeps the overlay connected, so the lock survives. A
* detach with a re-insert in a later task releases it, which is the shape a
@@ -570,6 +587,8 @@ export const restoreRootFocusTrapAccessibility = (overlayEl: HTMLIonOverlayEleme
return;
}
+ updateCloseWatcher();
+
const el = overlayEl as OverlayWithFocusTrapProps;
if (!locksAppRoot(el)) {
return;
@@ -828,6 +847,12 @@ export const dismiss = async (
overlay.el.remove();
+ /**
+ * Release the back button if nothing
+ * else is left to close.
+ */
+ updateCloseWatcher();
+
return true;
};
@@ -844,6 +869,13 @@ const overlayAnimation = async (
// Make overlay visible in case it's hidden
baseEl.classList.remove('overlay-hidden');
+ /**
+ * Removing `overlay-hidden` makes the overlay count
+ * as presented, so back can dismiss it while it
+ * animates in.
+ */
+ updateCloseWatcher();
+
const aniRoot = overlay.el;
const animation = animationBuilder(aniRoot, opts);
diff --git a/core/src/utils/test/hardware-back-button.spec.ts b/core/src/utils/test/hardware-back-button.spec.ts
index 87f27d407cc..b195996c20d 100644
--- a/core/src/utils/test/hardware-back-button.spec.ts
+++ b/core/src/utils/test/hardware-back-button.spec.ts
@@ -1,7 +1,8 @@
+import { newSpecPage } from '@stencil/core/testing';
+
import type { BackButtonEvent } from '../../../src/interface';
import { startHardwareBackButton } from '../hardware-back-button';
import { config } from '../../global/config';
-import { win } from '@utils/browser';
describe('Hardware Back Button', () => {
beforeEach(() => startHardwareBackButton());
@@ -58,52 +59,216 @@ describe('Hardware Back Button', () => {
describe('Experimental Close Watcher', () => {
test('should not use the Close Watcher API when available', () => {
- const mockAPI = mockCloseWatcher();
+ const closeWatchers = mockCloseWatcher();
config.reset({ experimentalCloseWatcher: false });
startHardwareBackButton();
- expect(mockAPI.mock.calls).toHaveLength(0);
+ expect(closeWatchers.created).toBe(0);
});
- test('should use the Close Watcher API when available', () => {
- const mockAPI = mockCloseWatcher();
- config.reset({ experimentalCloseWatcher: true });
+ test('should still handle the native back button event', async () => {
+ await newCloseWatcherPage(``);
- startHardwareBackButton();
+ const cbSpy = jest.fn();
+ document.addEventListener('ionBackButton', (ev) => {
+ (ev as BackButtonEvent).detail.register(0, cbSpy);
+ });
+
+ dispatchBackButtonEvent();
- expect(mockAPI.mock.calls).toHaveLength(1);
+ expect(cbSpy).toHaveBeenCalled();
});
- test('Close Watcher should dispatch ionBackButton events', () => {
- const mockAPI = mockCloseWatcher();
- config.reset({ experimentalCloseWatcher: true });
+ // Fixes https://github.com/ionic-team/ionic-framework/issues/29648
+ test('should not intercept the back button while nothing is open', async () => {
+ const { closeWatchers } = await newCloseWatcherPage(``);
- startHardwareBackButton();
+ expect(closeWatchers.active()).toBeUndefined();
+ });
- const cbSpy = jest.fn();
- document.addEventListener('ionBackButton', cbSpy);
+ test('should not intercept the back button while only a toast is shown', async () => {
+ const { page, closeWatchers } = await newCloseWatcherPage(``);
- // Call onclose on Ionic's instance of CloseWatcher
- mockAPI.getMockImplementation()!().onclose();
+ await page.body.querySelector('ion-toast')!.present();
- expect(cbSpy).toHaveBeenCalled();
+ expect(closeWatchers.active()).toBeUndefined();
+ });
+
+ test('should dismiss a presented modal when the back button is pressed', async () => {
+ const { page, closeWatchers } = await newCloseWatcherPage(``);
+
+ const modal = page.body.querySelector('ion-modal')!;
+ await modal.present();
+
+ expect(closeWatchers.active()).toBeDefined();
+
+ const dismissed = modal.onDidDismiss();
+ closeWatchers.requestClose();
+
+ await expect(dismissed).resolves.toEqual(expect.objectContaining({ role: 'backdrop' }));
+ });
+
+ // Fixes https://github.com/ionic-team/ionic-framework/issues/29648
+ test('should stop intercepting the back button once the modal is dismissed', async () => {
+ const { page, closeWatchers } = await newCloseWatcherPage(``);
+
+ const modal = page.body.querySelector('ion-modal')!;
+ await modal.present();
+ await modal.dismiss();
+
+ expect(closeWatchers.active()).toBeUndefined();
+ });
+
+ test('should stop intercepting the back button when a presented modal is removed without dismissing', async () => {
+ const { page, closeWatchers } = await newCloseWatcherPage(``);
+
+ const modal = page.body.querySelector('ion-modal')!;
+ await modal.present();
+ modal.remove();
+
+ expect(closeWatchers.active()).toBeUndefined();
+ });
+
+ test('should keep intercepting the back button when a presented modal is moved', async () => {
+ const { page, closeWatchers } = await newCloseWatcherPage(``);
+
+ const modal = page.body.querySelector('ion-modal')!;
+ await modal.present();
+ page.body.querySelector('#target')!.appendChild(modal);
+
+ expect(closeWatchers.active()).toBeDefined();
+ });
+
+ test('should keep intercepting the back button while a modal is still open underneath', async () => {
+ const { page, closeWatchers } = await newCloseWatcherPage(`
+
+
+ `);
+
+ const bottom = page.body.querySelector('#bottom')!;
+ const top = page.body.querySelector('#top')!;
+ await bottom.present();
+ await top.present();
+
+ const topDismissed = top.onDidDismiss();
+ closeWatchers.requestClose();
+ await topDismissed;
+
+ const bottomDismissed = bottom.onDidDismiss();
+ closeWatchers.requestClose();
+
+ await expect(bottomDismissed).resolves.toEqual(expect.objectContaining({ role: 'backdrop' }));
+ expect(closeWatchers.active()).toBeUndefined();
+ });
+
+ test('should keep intercepting the back button when the modal refuses to dismiss', async () => {
+ const { page, closeWatchers } = await newCloseWatcherPage(``);
+
+ const modal = page.body.querySelector('ion-modal')!;
+ let dismissAttempts = 0;
+ modal.canDismiss = () => {
+ dismissAttempts++;
+ return Promise.resolve(false);
+ };
+ await modal.present();
+
+ closeWatchers.requestClose();
+ await page.waitForChanges();
+ closeWatchers.requestClose();
+ await page.waitForChanges();
+
+ expect(dismissAttempts).toBe(2);
+ });
+
+ test('should dismiss a modal that allows backdrop dismissal only after it was presented', async () => {
+ const { page, closeWatchers } = await newCloseWatcherPage(``);
+
+ const modal = page.body.querySelector('ion-modal')!;
+ modal.backdropDismiss = false;
+ await modal.present();
+ modal.backdropDismiss = true;
+
+ const dismissed = modal.onDidDismiss();
+ closeWatchers.requestClose();
+
+ await expect(dismissed).resolves.toEqual(expect.objectContaining({ role: 'backdrop' }));
+ });
+
+ test('should keep intercepting the back button while a toast is shown over a modal', async () => {
+ const { page, closeWatchers } = await newCloseWatcherPage(`
+
+
+ `);
+
+ await page.body.querySelector('ion-modal')!.present();
+ await page.body.querySelector('ion-toast')!.present();
+
+ expect(closeWatchers.active()).toBeDefined();
});
});
+/**
+ * Modules are reset first because overlays attach their back button
+ * listener once per module load, and every spec page gets a new document.
+ */
+const newCloseWatcherPage = async (html: string) => {
+ jest.resetModules();
+ const { Modal } = await import('../../components/modal/modal');
+ const { Toast } = await import('../../components/toast/toast');
+ const { startHardwareBackButton } = await import('../hardware-back-button');
+ const { config } = await import('../../global/config');
+
+ const page = await newSpecPage({ components: [Modal, Toast], html });
+
+ // Install the mock after newSpecPage, which resets the window
+ const closeWatchers = mockCloseWatcher();
+ config.reset({ experimentalCloseWatcher: true });
+ startHardwareBackButton();
+
+ return { page, closeWatchers };
+};
+
+/**
+ * Like the browser, only the newest watcher that hasn't
+ * been destroyed gets close requests.
+ */
const mockCloseWatcher = () => {
- const mockCloseWatcher = jest.fn();
- mockCloseWatcher.mockReturnValue({
- requestClose: () => null,
- close: () => null,
- destroy: () => null,
- oncancel: () => null,
- onclose: () => null,
- });
- (win as any).CloseWatcher = mockCloseWatcher;
+ const watchers: { destroyed: boolean; onclose: (() => void) | null; destroy: () => void }[] = [];
+
+ (window as any).CloseWatcher = class {
+ destroyed = false;
+ onclose: (() => void) | null = null;
+
+ constructor() {
+ watchers.push(this);
+ }
+
+ destroy() {
+ this.destroyed = true;
+ }
+ };
+
+ const active = () => watchers.filter((w) => !w.destroyed).slice(-1)[0];
- return mockCloseWatcher;
+ return {
+ get created() {
+ return watchers.length;
+ },
+ active,
+ /**
+ * Presses back. Like the browser, this destroys
+ * the watcher before firing `close`.
+ */
+ requestClose() {
+ const watcher = active();
+ if (watcher) {
+ watcher.destroyed = true;
+ watcher.onclose?.();
+ }
+ },
+ };
};
const dispatchBackButtonEvent = () => {
diff --git a/lerna.json b/lerna.json
index 3574ffe91d1..e51c4efd2b8 100644
--- a/lerna.json
+++ b/lerna.json
@@ -10,5 +10,5 @@
"packages/vue",
"packages/vue-router"
],
- "version": "9.0.6"
+ "version": "9.0.7"
}
\ No newline at end of file
diff --git a/packages/angular-server/CHANGELOG.md b/packages/angular-server/CHANGELOG.md
index bc1aabd84af..e69e5c68e8a 100644
--- a/packages/angular-server/CHANGELOG.md
+++ b/packages/angular-server/CHANGELOG.md
@@ -3,6 +3,14 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [9.0.7](https://github.com/ionic-team/ionic-framework/compare/v9.0.6...v9.0.7) (2026-10-07)
+
+**Note:** Version bump only for package @ionic/angular-server
+
+
+
+
+
## [9.0.6](https://github.com/ionic-team/ionic-framework/compare/v9.0.5...v9.0.6) (2026-09-30)
**Note:** Version bump only for package @ionic/angular-server
diff --git a/packages/angular-server/package-lock.json b/packages/angular-server/package-lock.json
index b4e2f8ed9bb..b582693e993 100644
--- a/packages/angular-server/package-lock.json
+++ b/packages/angular-server/package-lock.json
@@ -1,15 +1,15 @@
{
"name": "@ionic/angular-server",
- "version": "9.0.6",
+ "version": "9.0.7",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@ionic/angular-server",
- "version": "9.0.6",
+ "version": "9.0.7",
"license": "MIT",
"dependencies": {
- "@ionic/core": "^9.0.6"
+ "@ionic/core": "^9.0.7"
},
"devDependencies": {
"@angular/animations": "^22.0.0",
@@ -1097,9 +1097,9 @@
}
},
"node_modules/@ionic/core": {
- "version": "9.0.5",
- "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.5.tgz",
- "integrity": "sha512-Fo3hC0f7YI3XP0eAUUlm49q00u0OG0z55+EZ+s2YZHCUyNL1xq20JKtiPf79pn2tJ8CAYw4u52x6QcWUkL4P3A==",
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.6.tgz",
+ "integrity": "sha512-WWxjOjwKPU75BuEhc42t3n2Tn89YEDe5Pce9kA61w/TlWVM3tqiAYC+qfR9MXmER4pQcST01oM2gftheMzcV6g==",
"license": "MIT",
"dependencies": {
"@stencil/core": "^4.44.2",
diff --git a/packages/angular-server/package.json b/packages/angular-server/package.json
index 77424e5e919..5ac7080e8e6 100644
--- a/packages/angular-server/package.json
+++ b/packages/angular-server/package.json
@@ -1,6 +1,6 @@
{
"name": "@ionic/angular-server",
- "version": "9.0.6",
+ "version": "9.0.7",
"description": "Angular SSR Module for Ionic",
"keywords": [
"ionic",
@@ -78,6 +78,6 @@
},
"prettier": "@ionic/prettier-config",
"dependencies": {
- "@ionic/core": "^9.0.6"
+ "@ionic/core": "^9.0.7"
}
}
diff --git a/packages/angular/CHANGELOG.md b/packages/angular/CHANGELOG.md
index b95833b97e7..21fcd6500c0 100644
--- a/packages/angular/CHANGELOG.md
+++ b/packages/angular/CHANGELOG.md
@@ -3,6 +3,14 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [9.0.7](https://github.com/ionic-team/ionic-framework/compare/v9.0.6...v9.0.7) (2026-10-07)
+
+**Note:** Version bump only for package @ionic/angular
+
+
+
+
+
## [9.0.6](https://github.com/ionic-team/ionic-framework/compare/v9.0.5...v9.0.6) (2026-09-30)
**Note:** Version bump only for package @ionic/angular
diff --git a/packages/angular/package-lock.json b/packages/angular/package-lock.json
index ddf33cabd7b..186a6be0fd4 100644
--- a/packages/angular/package-lock.json
+++ b/packages/angular/package-lock.json
@@ -1,15 +1,15 @@
{
"name": "@ionic/angular",
- "version": "9.0.6",
+ "version": "9.0.7",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@ionic/angular",
- "version": "9.0.6",
+ "version": "9.0.7",
"license": "MIT",
"dependencies": {
- "@ionic/core": "^9.0.6",
+ "@ionic/core": "^9.0.7",
"ionicons": "^8.0.13",
"jsonc-parser": "^3.0.0",
"tslib": "^2.3.0"
@@ -1580,9 +1580,9 @@
}
},
"node_modules/@ionic/core": {
- "version": "9.0.5",
- "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.5.tgz",
- "integrity": "sha512-Fo3hC0f7YI3XP0eAUUlm49q00u0OG0z55+EZ+s2YZHCUyNL1xq20JKtiPf79pn2tJ8CAYw4u52x6QcWUkL4P3A==",
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.6.tgz",
+ "integrity": "sha512-WWxjOjwKPU75BuEhc42t3n2Tn89YEDe5Pce9kA61w/TlWVM3tqiAYC+qfR9MXmER4pQcST01oM2gftheMzcV6g==",
"license": "MIT",
"dependencies": {
"@stencil/core": "^4.44.2",
diff --git a/packages/angular/package.json b/packages/angular/package.json
index 52fcb205f52..4ae8d969edc 100644
--- a/packages/angular/package.json
+++ b/packages/angular/package.json
@@ -1,6 +1,6 @@
{
"name": "@ionic/angular",
- "version": "9.0.6",
+ "version": "9.0.7",
"description": "Angular specific wrappers for @ionic/core",
"keywords": [
"ionic",
@@ -168,7 +168,7 @@
"css/"
],
"dependencies": {
- "@ionic/core": "^9.0.6",
+ "@ionic/core": "^9.0.7",
"ionicons": "^8.0.13",
"jsonc-parser": "^3.0.0",
"tslib": "^2.3.0"
diff --git a/packages/docs/CHANGELOG.md b/packages/docs/CHANGELOG.md
index c41faa00af0..3cfe8d8f92a 100644
--- a/packages/docs/CHANGELOG.md
+++ b/packages/docs/CHANGELOG.md
@@ -3,6 +3,14 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [9.0.7](https://github.com/ionic-team/ionic-framework/compare/v9.0.6...v9.0.7) (2026-10-07)
+
+**Note:** Version bump only for package @ionic/docs
+
+
+
+
+
## [9.0.6](https://github.com/ionic-team/ionic-framework/compare/v9.0.5...v9.0.6) (2026-09-30)
**Note:** Version bump only for package @ionic/docs
diff --git a/packages/docs/package-lock.json b/packages/docs/package-lock.json
index 017f1bcf4ff..7321c80f8fa 100644
--- a/packages/docs/package-lock.json
+++ b/packages/docs/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@ionic/docs",
- "version": "9.0.6",
+ "version": "9.0.7",
"lockfileVersion": 2,
"requires": true,
"packages": {
"": {
"name": "@ionic/docs",
- "version": "9.0.6",
+ "version": "9.0.7",
"license": "MIT"
}
}
diff --git a/packages/docs/package.json b/packages/docs/package.json
index 073f240f010..c135f08f56d 100644
--- a/packages/docs/package.json
+++ b/packages/docs/package.json
@@ -1,6 +1,6 @@
{
"name": "@ionic/docs",
- "version": "9.0.6",
+ "version": "9.0.7",
"description": "Pre-packaged API documentation for the Ionic docs.",
"main": "core.json",
"types": "core.d.ts",
diff --git a/packages/migrate/package-lock.json b/packages/migrate/package-lock.json
index 4714971f7aa..6abc6ef26e5 100644
--- a/packages/migrate/package-lock.json
+++ b/packages/migrate/package-lock.json
@@ -970,9 +970,9 @@
"license": "MIT"
},
"node_modules/@types/node": {
- "version": "24.19.0",
- "resolved": "https://registry.npmjs.org/@types/node/-/node-24.19.0.tgz",
- "integrity": "sha512-zY+5tKxXdhGh1PYI0ac+7juvEu4OI6vWtVVoj5i2m42jxAY1U+zHGt6QCyOFwykdP62sM3MJ9stoYYUw5aCWew==",
+ "version": "24.19.1",
+ "resolved": "https://registry.npmjs.org/@types/node/-/node-24.19.1.tgz",
+ "integrity": "sha512-aS3/DG0oM05K0RIXXP+hKjinGG5IgSSVGzswZxW3O0sS3pH4/fycXundUC9XsszgKCk4gHXylTEK6hyFxVxnoQ==",
"dev": true,
"license": "MIT",
"dependencies": {
@@ -980,14 +980,14 @@
}
},
"node_modules/@vitest/mocker": {
- "version": "5.0.2",
- "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-5.0.2.tgz",
- "integrity": "sha512-Z5FS00Q1SJHkB35xATsmWGdQ5WA1/0MV3CDjqyv7GavHv1OfOj145MNfHOlHk7QLes21dKFDHr8EO2zvL+9WGA==",
+ "version": "5.0.3",
+ "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-5.0.3.tgz",
+ "integrity": "sha512-T8sWAIbkSyAjkwTcaEc3Iu0o9A27X1/kdXrizhZkGuSKScRQtRzclfAMpOTcGdXCsqxeWlpGy3XjqaW8CpLORg==",
"dev": true,
"license": "MIT",
"dependencies": {
"@jridgewell/trace-mapping": "0.3.31",
- "@vitest/spy": "5.0.2",
+ "@vitest/spy": "5.0.3",
"estree-walker": "^3.0.3",
"magic-string": "^1.2.3"
},
@@ -1008,9 +1008,9 @@
}
},
"node_modules/@vitest/spy": {
- "version": "5.0.2",
- "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-5.0.2.tgz",
- "integrity": "sha512-Ijc7T1nT9efNb5LxvjaBrEqw3f/QwUv5EE0nKqZxgqsaV/FxAAZ8baGylA8X/Z2oS4Lp+K74Jr6dTJsDKxJDeg==",
+ "version": "5.0.3",
+ "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-5.0.3.tgz",
+ "integrity": "sha512-XhFysQTB8AZ+P4gMi+Lpo99vg2AZi0qKpaB9yXQl37+CaMEAPO3iH/wGVnSyL5MPERiLezpqTVtrR6UZH5GCXg==",
"dev": true,
"license": "MIT",
"funding": {
@@ -1509,14 +1509,14 @@
}
},
"node_modules/vitest": {
- "version": "5.0.2",
- "resolved": "https://registry.npmjs.org/vitest/-/vitest-5.0.2.tgz",
- "integrity": "sha512-7MQrx9pDv5aHiUcovIb/70Ys3tgtkUVgCtledvKdCmEO+/1Dicq5ZqoSxOW034m03oqC+oHOKui2dM6qtMLoJg==",
+ "version": "5.0.3",
+ "resolved": "https://registry.npmjs.org/vitest/-/vitest-5.0.3.tgz",
+ "integrity": "sha512-xMw97S3rjdtj5dkVat7jCsqWBpvchs3RlpQctUqwJD0KkERk40vz2fJ77lDwW/Vzh/pk18eItYAzkodhSes3jQ==",
"dev": true,
"license": "MIT",
"dependencies": {
"@types/chai": "^5.2.2",
- "@vitest/mocker": "5.0.2",
+ "@vitest/mocker": "5.0.3",
"chai": "^6.2.2",
"es-module-lexer": "^2.3.2",
"expect-type": "^1.4.0",
@@ -1527,7 +1527,7 @@
"tinybench": "^6.1.4",
"tinyexec": "^1.3.0",
"tinyglobby": "^0.2.17",
- "why-is-node-running": "^3.2.1"
+ "why-is-node-running": "3.2.1"
},
"bin": {
"vitest": "vitest.mjs"
@@ -1542,12 +1542,12 @@
"@edge-runtime/vm": "*",
"@opentelemetry/api": "^1.9.0",
"@types/node": "^22.0.0 || >=24.0.0",
- "@vitest/browser-playwright": "5.0.2",
- "@vitest/browser-preview": "5.0.2",
+ "@vitest/browser-playwright": "5.0.3",
+ "@vitest/browser-preview": "5.0.3",
"@vitest/browser-webdriverio": "^5.0.0-beta.5 || >=5.0.0",
- "@vitest/coverage-istanbul": "5.0.2",
- "@vitest/coverage-v8": "5.0.2",
- "@vitest/ui": "5.0.2",
+ "@vitest/coverage-istanbul": "5.0.3",
+ "@vitest/coverage-v8": "5.0.3",
+ "@vitest/ui": "5.0.3",
"happy-dom": "*",
"jsdom": "*",
"vite": "^6.4.0 || ^7.0.0 || ^8.0.0"
@@ -1591,10 +1591,10 @@
}
}
},
- "node_modules/why-is-node-running": {
- "version": "3.2.2",
- "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-3.2.2.tgz",
- "integrity": "sha512-NKUzAelcoCXhXL4dJzKIwXeR8iEVqsA0Lq6Vnd0UXvgaKbzVo4ZTHROF2Jidrv+SgxOQ03fMinnNhzZATxOD3A==",
+ "node_modules/vitest/node_modules/why-is-node-running": {
+ "version": "3.2.1",
+ "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-3.2.1.tgz",
+ "integrity": "sha512-Tb2FUhB4vUsGQlfSquQLYkApkuPAFQXGFzxWKHHumVz2dK+X1RUm/HnID4+TfIGYJ1kTcwOaCk/buYCEJr6YjQ==",
"dev": true,
"license": "MIT",
"bin": {
diff --git a/packages/react-router/CHANGELOG.md b/packages/react-router/CHANGELOG.md
index a9b898792a1..2051b697ae5 100644
--- a/packages/react-router/CHANGELOG.md
+++ b/packages/react-router/CHANGELOG.md
@@ -3,6 +3,13 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [9.0.7](https://github.com/ionic-team/ionic-framework/compare/v9.0.6...v9.0.7) (2026-10-07)
+
+### Bug Fixes
+
+* **react:** prevent error when an outlet unmounts before it's ready ([#31517](https://github.com/ionic-team/ionic-framework/issues/31517)) ([d5bab2e](https://github.com/ionic-team/ionic-framework/commit/d5bab2e89548311b2e3f62b5fe2be477685cb06d)), closes [#31513](https://github.com/ionic-team/ionic-framework/issues/31513)
+
+
## [9.0.6](https://github.com/ionic-team/ionic-framework/compare/v9.0.5...v9.0.6) (2026-09-30)
### Bug Fixes
diff --git a/packages/react-router/package-lock.json b/packages/react-router/package-lock.json
index 369fd43b5e9..f422dad9a6e 100644
--- a/packages/react-router/package-lock.json
+++ b/packages/react-router/package-lock.json
@@ -1,16 +1,16 @@
{
"name": "@ionic/react-router",
- "version": "9.0.6",
+ "version": "9.0.7",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@ionic/react-router",
- "version": "9.0.6",
+ "version": "9.0.7",
"license": "MIT",
"dependencies": {
- "@ionic/core": "^9.0.6",
- "@ionic/react": "^9.0.6",
+ "@ionic/core": "^9.0.7",
+ "@ionic/react": "^9.0.7",
"tslib": "*"
},
"devDependencies": {
@@ -257,9 +257,9 @@
}
},
"node_modules/@ionic/core": {
- "version": "9.0.5",
- "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.5.tgz",
- "integrity": "sha512-Fo3hC0f7YI3XP0eAUUlm49q00u0OG0z55+EZ+s2YZHCUyNL1xq20JKtiPf79pn2tJ8CAYw4u52x6QcWUkL4P3A==",
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.6.tgz",
+ "integrity": "sha512-WWxjOjwKPU75BuEhc42t3n2Tn89YEDe5Pce9kA61w/TlWVM3tqiAYC+qfR9MXmER4pQcST01oM2gftheMzcV6g==",
"license": "MIT",
"dependencies": {
"@stencil/core": "^4.44.2",
@@ -297,12 +297,12 @@
}
},
"node_modules/@ionic/react": {
- "version": "9.0.5",
- "resolved": "https://registry.npmjs.org/@ionic/react/-/react-9.0.5.tgz",
- "integrity": "sha512-a77jWFtVxWZ5nprZqu8DMOpPjwIoCX3UxUbgQcPQ2ARu4a+Lqr9s045ddFoo8NHDCfBTcpMFbIby0Sns6AOMrQ==",
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@ionic/react/-/react-9.0.6.tgz",
+ "integrity": "sha512-WAcbe7ZDIDqQaXvcAF7+AxpYW3Y3HFvZbDnpwQtoSUo8RTAw+AQQOTTSlp1eHOjwqpVqYceBFAdhfNbzBfw/1w==",
"license": "MIT",
"dependencies": {
- "@ionic/core": "9.0.5",
+ "@ionic/core": "9.0.6",
"@stencil/react-output-target": "^1.6.2",
"ionicons": "^8.0.13",
"tslib": "*"
diff --git a/packages/react-router/package.json b/packages/react-router/package.json
index d9751e3ec8d..710cdb4afcc 100644
--- a/packages/react-router/package.json
+++ b/packages/react-router/package.json
@@ -1,6 +1,6 @@
{
"name": "@ionic/react-router",
- "version": "9.0.6",
+ "version": "9.0.7",
"description": "React Router wrapper for @ionic/react",
"keywords": [
"ionic",
@@ -37,8 +37,8 @@
"dist/"
],
"dependencies": {
- "@ionic/core": "^9.0.6",
- "@ionic/react": "^9.0.6",
+ "@ionic/core": "^9.0.7",
+ "@ionic/react": "^9.0.7",
"tslib": "*"
},
"peerDependencies": {
diff --git a/packages/react-router/test/base/src/App.tsx b/packages/react-router/test/base/src/App.tsx
index 96cb242cedc..64dfdffb265 100644
--- a/packages/react-router/test/base/src/App.tsx
+++ b/packages/react-router/test/base/src/App.tsx
@@ -56,6 +56,7 @@ import {
} from './pages/router-link-modifier-click/RouterLinkModifierClick';
import { NavigateRootPageA, NavigateRootPageB, NavigateRootPageC } from './pages/navigate-root/NavigateRoot';
import SuspenseOutlet from './pages/suspense-outlet/SuspenseOutlet';
+import OutletUnmountBeforeReady from './pages/outlet-unmount-before-ready/OutletUnmountBeforeReady';
import { PropsUpdateDirect, PropsUpdateRoutesWrapper } from './pages/props-update/PropsUpdate';
import DisabledButton from './pages/disabled-button/DisabledButton';
import SplatSibling from './pages/splat-sibling/SplatSibling';
@@ -126,6 +127,7 @@ const App: React.FC = () => {
} />
} />
} />
+ } />
} />
} />
} />
diff --git a/packages/react-router/test/base/src/pages/Main.tsx b/packages/react-router/test/base/src/pages/Main.tsx
index 3dc6709f531..f23ceb89a02 100644
--- a/packages/react-router/test/base/src/pages/Main.tsx
+++ b/packages/react-router/test/base/src/pages/Main.tsx
@@ -58,6 +58,9 @@ const Main: React.FC = () => {
Suspense Outlet
+
+ Outlet Unmount Before Ready
+
diff --git a/packages/react-router/test/base/src/pages/outlet-unmount-before-ready/OutletUnmountBeforeReady.tsx b/packages/react-router/test/base/src/pages/outlet-unmount-before-ready/OutletUnmountBeforeReady.tsx
new file mode 100644
index 00000000000..f8bb19ff958
--- /dev/null
+++ b/packages/react-router/test/base/src/pages/outlet-unmount-before-ready/OutletUnmountBeforeReady.tsx
@@ -0,0 +1,52 @@
+import { IonButton, IonContent, IonHeader, IonPage, IonRouterOutlet, IonTitle, IonToolbar } from '@ionic/react';
+import React, { useLayoutEffect, useState } from 'react';
+import { Route } from 'react-router-dom';
+
+import TestDescription from '../../components/TestDescription';
+
+/**
+ * Unmounting from a layout effect removes the outlet before it's ready.
+ */
+const TransientOutlet: React.FC<{ onMounted: () => void }> = ({ onMounted }) => {
+ useLayoutEffect(onMounted, [onMounted]);
+
+ return (
+
+ Transient page} />
+
+ );
+};
+
+const OutletUnmountBeforeReady: React.FC = () => {
+ const [mounted, setMounted] = useState(false);
+ const [attempts, setAttempts] = useState(0);
+
+ return (
+
+
+
+ Outlet Unmount Before Ready
+
+
+
+
+ Tap the button a few times. Each tap mounts a nested outlet and removes it before it's ready, so the counter
+ should go up without any errors in the console.
+
+ {
+ setAttempts((count) => count + 1);
+ setMounted(true);
+ }}
+ >
+ Mount and unmount outlet
+
+ {attempts}
+ {mounted && setMounted(false)} />}
+
+
+ );
+};
+
+export default OutletUnmountBeforeReady;
diff --git a/packages/react-router/test/base/tests/e2e/playwright/outlet-unmount-before-ready.spec.ts b/packages/react-router/test/base/tests/e2e/playwright/outlet-unmount-before-ready.spec.ts
new file mode 100644
index 00000000000..b3c14a5dbbd
--- /dev/null
+++ b/packages/react-router/test/base/tests/e2e/playwright/outlet-unmount-before-ready.spec.ts
@@ -0,0 +1,28 @@
+import { test, expect } from '@playwright/test';
+import { ionPageVisible, withTestingMode } from './utils/test-utils';
+
+test.describe('Outlet Unmount Before Ready', () => {
+ test('should not throw when an ionPage outlet unmounts before it is ready', async ({ page }, testInfo) => {
+ testInfo.annotations.push({
+ type: 'issue',
+ description: 'https://github.com/ionic-team/ionic-framework/issues/31513',
+ });
+
+ const errors: string[] = [];
+ page.on('pageerror', (error) => errors.push(error.message));
+
+ await page.goto(withTestingMode('/outlet-unmount-before-ready'));
+ await ionPageVisible(page, 'outlet-unmount-before-ready');
+
+ for (let attempt = 1; attempt <= 3; attempt++) {
+ await page.locator('#mount-transient-outlet').click();
+ await expect(page.locator('#attempts')).toHaveText(String(attempt));
+ }
+
+ // Give the async ready callback time to fire.
+ await page.waitForTimeout(500);
+
+ expect(errors).toEqual([]);
+ await ionPageVisible(page, 'outlet-unmount-before-ready');
+ });
+});
diff --git a/packages/react/CHANGELOG.md b/packages/react/CHANGELOG.md
index 86049812550..8dba032817f 100644
--- a/packages/react/CHANGELOG.md
+++ b/packages/react/CHANGELOG.md
@@ -3,6 +3,13 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [9.0.7](https://github.com/ionic-team/ionic-framework/compare/v9.0.6...v9.0.7) (2026-10-07)
+
+### Bug Fixes
+
+* **react:** prevent error when an outlet unmounts before it's ready ([#31517](https://github.com/ionic-team/ionic-framework/issues/31517)) ([d5bab2e](https://github.com/ionic-team/ionic-framework/commit/d5bab2e89548311b2e3f62b5fe2be477685cb06d)), closes [#31513](https://github.com/ionic-team/ionic-framework/issues/31513)
+
+
## [9.0.6](https://github.com/ionic-team/ionic-framework/compare/v9.0.5...v9.0.6) (2026-09-30)
**Note:** Version bump only for package @ionic/react
diff --git a/packages/react/package-lock.json b/packages/react/package-lock.json
index d950b7a4367..e71b147950d 100644
--- a/packages/react/package-lock.json
+++ b/packages/react/package-lock.json
@@ -1,15 +1,15 @@
{
"name": "@ionic/react",
- "version": "9.0.6",
+ "version": "9.0.7",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@ionic/react",
- "version": "9.0.6",
+ "version": "9.0.7",
"license": "MIT",
"dependencies": {
- "@ionic/core": "^9.0.6",
+ "@ionic/core": "^9.0.7",
"@stencil/react-output-target": "^1.6.2",
"ionicons": "^8.0.13",
"tslib": "*"
@@ -891,9 +891,9 @@
}
},
"node_modules/@ionic/core": {
- "version": "9.0.5",
- "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.5.tgz",
- "integrity": "sha512-Fo3hC0f7YI3XP0eAUUlm49q00u0OG0z55+EZ+s2YZHCUyNL1xq20JKtiPf79pn2tJ8CAYw4u52x6QcWUkL4P3A==",
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.6.tgz",
+ "integrity": "sha512-WWxjOjwKPU75BuEhc42t3n2Tn89YEDe5Pce9kA61w/TlWVM3tqiAYC+qfR9MXmER4pQcST01oM2gftheMzcV6g==",
"license": "MIT",
"dependencies": {
"@stencil/core": "^4.44.2",
diff --git a/packages/react/package.json b/packages/react/package.json
index 6daf86bc3cd..4163da2e4f5 100644
--- a/packages/react/package.json
+++ b/packages/react/package.json
@@ -1,6 +1,6 @@
{
"name": "@ionic/react",
- "version": "9.0.6",
+ "version": "9.0.7",
"description": "React specific wrapper for @ionic/core",
"keywords": [
"ionic",
@@ -41,7 +41,7 @@
"css/"
],
"dependencies": {
- "@ionic/core": "^9.0.6",
+ "@ionic/core": "^9.0.7",
"@stencil/react-output-target": "^1.6.2",
"ionicons": "^8.0.13",
"tslib": "*"
diff --git a/packages/react/src/routing/OutletPageManager.tsx b/packages/react/src/routing/OutletPageManager.tsx
index abb9bda0481..056ab598534 100644
--- a/packages/react/src/routing/OutletPageManager.tsx
+++ b/packages/react/src/routing/OutletPageManager.tsx
@@ -46,7 +46,13 @@ export class OutletPageManager extends React.Component {
* when React unmounts + remounts components.
*/
if (!this.outletIsReady) {
- componentOnReady(this.ionRouterOutlet, () => {
+ const el = this.ionRouterOutlet;
+ componentOnReady(el, () => {
+ /**
+ * The outlet can unmount before this fires, which clears the ref.
+ */
+ if (this.ionRouterOutlet !== el) return;
+
/**
* Guard against duplicate callbacks from React strict mode double-mount.
* Both componentDidMount calls pass the outer !outletIsReady check before
@@ -65,7 +71,6 @@ export class OutletPageManager extends React.Component {
* outlet's forward animation removes ion-page-invisible, preventing
* a flash where the outlet is briefly visible at full opacity.
*/
- const el = this.ionRouterOutlet!;
if (!el.classList.contains('ion-page-invisible') && !el.classList.contains('ion-page-hidden')) {
el.classList.add('ion-page');
el.classList.add('ion-page-invisible');
diff --git a/packages/vue-router/CHANGELOG.md b/packages/vue-router/CHANGELOG.md
index dfe731e8669..975363c4fd2 100644
--- a/packages/vue-router/CHANGELOG.md
+++ b/packages/vue-router/CHANGELOG.md
@@ -3,6 +3,14 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [9.0.7](https://github.com/ionic-team/ionic-framework/compare/v9.0.6...v9.0.7) (2026-10-07)
+
+### Bug Fixes
+
+* **vue-router:** render the redirect target when a guard redirects ([#31510](https://github.com/ionic-team/ionic-framework/issues/31510)) ([643584b](https://github.com/ionic-team/ionic-framework/commit/643584b3ac2ba1ca263cbf53960ccde3be2a96fc))
+* **vue-router:** reset tab with memory history ([#31511](https://github.com/ionic-team/ionic-framework/issues/31511)) ([edbc304](https://github.com/ionic-team/ionic-framework/commit/edbc304fbc4179a668d0e170241abd78311fdb62)), closes [#29785](https://github.com/ionic-team/ionic-framework/issues/29785)
+
+
## [9.0.6](https://github.com/ionic-team/ionic-framework/compare/v9.0.5...v9.0.6) (2026-09-30)
**Note:** Version bump only for package @ionic/vue-router
diff --git a/packages/vue-router/package-lock.json b/packages/vue-router/package-lock.json
index d81d1afe245..79bacd79595 100644
--- a/packages/vue-router/package-lock.json
+++ b/packages/vue-router/package-lock.json
@@ -1,15 +1,15 @@
{
"name": "@ionic/vue-router",
- "version": "9.0.6",
+ "version": "9.0.7",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@ionic/vue-router",
- "version": "9.0.6",
+ "version": "9.0.7",
"license": "MIT",
"dependencies": {
- "@ionic/vue": "^9.0.6"
+ "@ionic/vue": "^9.0.7"
},
"devDependencies": {
"@eslint/eslintrc": "^3.3.1",
@@ -342,9 +342,9 @@
}
},
"node_modules/@ionic/core": {
- "version": "9.0.5",
- "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.5.tgz",
- "integrity": "sha512-Fo3hC0f7YI3XP0eAUUlm49q00u0OG0z55+EZ+s2YZHCUyNL1xq20JKtiPf79pn2tJ8CAYw4u52x6QcWUkL4P3A==",
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.6.tgz",
+ "integrity": "sha512-WWxjOjwKPU75BuEhc42t3n2Tn89YEDe5Pce9kA61w/TlWVM3tqiAYC+qfR9MXmER4pQcST01oM2gftheMzcV6g==",
"license": "MIT",
"dependencies": {
"@stencil/core": "^4.44.2",
@@ -382,12 +382,12 @@
}
},
"node_modules/@ionic/vue": {
- "version": "9.0.5",
- "resolved": "https://registry.npmjs.org/@ionic/vue/-/vue-9.0.5.tgz",
- "integrity": "sha512-d5HDYRynpr6OlMO4gawIPR4sSEBnc8yCtYWTx6W616HSMi3tEloncj2HPMQC/f8D75wTOTaVGDHkGg+LETDgDQ==",
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@ionic/vue/-/vue-9.0.6.tgz",
+ "integrity": "sha512-Bg8RqfnsVejulSXF+YENjZBtx1cEwZPUZAA47oLhFceYlSodapLI2qWeHgn6hgKmapCe+GzyJQIuxyRIfXqlXQ==",
"license": "MIT",
"dependencies": {
- "@ionic/core": "9.0.5",
+ "@ionic/core": "9.0.6",
"@stencil/vue-output-target": "0.14.2",
"ionicons": "^8.0.13"
}
diff --git a/packages/vue-router/package.json b/packages/vue-router/package.json
index 90a8eb8d520..0b7b563c7f7 100644
--- a/packages/vue-router/package.json
+++ b/packages/vue-router/package.json
@@ -1,6 +1,6 @@
{
"name": "@ionic/vue-router",
- "version": "9.0.6",
+ "version": "9.0.7",
"description": "Vue Router integration for @ionic/vue",
"scripts": {
"eslint": "eslint src",
@@ -44,7 +44,7 @@
},
"homepage": "https://github.com/ionic-team/ionic-framework#readme",
"dependencies": {
- "@ionic/vue": "^9.0.6"
+ "@ionic/vue": "^9.0.7"
},
"devDependencies": {
"@eslint/eslintrc": "^3.3.1",
diff --git a/packages/vue-router/src/router.ts b/packages/vue-router/src/router.ts
index 7045dad5947..365b8454b40 100644
--- a/packages/vue-router/src/router.ts
+++ b/packages/vue-router/src/router.ts
@@ -117,10 +117,6 @@ export const createIonRouter = (
* instead, so there is no failure to inspect there and the staged state
* would survive. The error is re-thrown to the app the same way it was
* before, so navigation outcomes are unchanged.
- *
- * A guard that returns a location is still not covered, because that
- * redirects rather than fails and afterEach is never called for the original
- * navigation.
*/
addErrorHandler((error: unknown, to: RouteLocationNormalized) => {
discardStagedStateFor(to);
@@ -183,20 +179,71 @@ export const createIonRouter = (
incomingRouteParamsUnclaimed = false;
};
+ /**
+ * Whether `to` is a guard redirect of the navigation that claimed `owner`.
+ * vue-router points `redirectedFrom` at the first location in a redirect
+ * chain, so an owner that a `redirect:` record led to is matched on its own
+ * `redirectedFrom`.
+ */
+ const isGuardRedirectOf = (
+ owner: RouteLocationNormalized | undefined,
+ to: RouteLocationNormalized
+ ) =>
+ owner !== undefined &&
+ to.redirectedFrom !== undefined &&
+ (owner.redirectedFrom ?? owner) === to.redirectedFrom;
+
+ /**
+ * Whether `to` was redirected by a guard rather than a `redirect:` record.
+ * This can't tell a record redirect apart from one a leave guard redirected
+ * again afterwards.
+ */
+ const isRedirectedByGuard = (to: RouteLocationNormalized) => {
+ const origin = to.redirectedFrom;
+
+ return (
+ origin !== undefined &&
+ origin.matched[origin.matched.length - 1]?.redirect === undefined
+ );
+ };
+
/**
* The navigation that starts first after params are staged is the one they
* were staged for, so it takes ownership of them here. Registered before any
* guard the app adds so that it still runs when one of those aborts.
+ *
+ * A guard that returns a location starts a new navigation and the original
+ * never reaches afterEach or onError, so we discard what it claimed here
+ * instead. Leave guards run before this hook, so a navigation they redirect
+ * hasn't claimed anything yet and its state is discarded unclaimed.
*/
router.beforeEach((to: RouteLocationNormalized) => {
+ if (isGuardRedirectOf(currentNavigationInfoOwner, to)) {
+ clearNavigationInfo();
+ }
+
+ if (isGuardRedirectOf(incomingRouteParamsOwner, to)) {
+ clearStagedParams();
+ }
+
+ const redirectedByGuard = isRedirectedByGuard(to);
+
if (incomingRouteParamsUnclaimed) {
- incomingRouteParamsOwner = to;
- incomingRouteParamsUnclaimed = false;
+ if (redirectedByGuard) {
+ clearStagedParams();
+ } else {
+ incomingRouteParamsOwner = to;
+ incomingRouteParamsUnclaimed = false;
+ }
}
if (currentNavigationInfoUnclaimed) {
- currentNavigationInfoOwner = to;
- currentNavigationInfoUnclaimed = false;
+ if (redirectedByGuard) {
+ clearNavigationInfo();
+ } else {
+ currentNavigationInfoOwner = to;
+ currentNavigationInfoUnclaimed = false;
+ }
}
});
@@ -219,18 +266,22 @@ export const createIonRouter = (
* Both are matched on the navigation that owns them rather than on where it
* was heading, because two navigations can head for the same path and a path
* cannot tell them apart. State still unclaimed belongs to this navigation,
- * since nothing has started since it was staged.
+ * since nothing has started since it was staged. A guard redirect that fails
+ * before reaching beforeEach, like one to the current page, is matched
+ * through the navigation it redirected.
*/
const discardStagedStateFor = (to: RouteLocationNormalized) => {
const deltaIsForThisNavigation =
currentNavigationInfoOwner === undefined
? currentNavigationInfoUnclaimed
- : currentNavigationInfoOwner === to;
+ : currentNavigationInfoOwner === to ||
+ isGuardRedirectOf(currentNavigationInfoOwner, to);
const paramsAreForThisNavigation =
incomingRouteParamsOwner === undefined
? incomingRouteParamsUnclaimed
- : incomingRouteParamsOwner === to;
+ : incomingRouteParamsOwner === to ||
+ isGuardRedirectOf(incomingRouteParamsOwner, to);
if (deltaIsForThisNavigation) {
clearNavigationInfo();
@@ -776,6 +827,16 @@ export const createIonRouter = (
const routeInfo = locationHistory.getFirstRouteInfoForTab(tab);
if (routeInfo) {
const delta = routeInfo.position! - currentHistoryPosition;
+ /**
+ * Memory history doesn't store a position in `history.state`, so
+ * `delta` is NaN and there's nothing to traverse. Replace instead.
+ */
+ if (Number.isNaN(delta)) {
+ if (originalHref) {
+ handleNavigate(originalHref, "pop", "back", undefined, tab);
+ }
+ return;
+ }
if (delta !== 0) {
router.go(delta);
return;
diff --git a/packages/vue/CHANGELOG.md b/packages/vue/CHANGELOG.md
index 4091f7d6fb2..33c1e3c0950 100644
--- a/packages/vue/CHANGELOG.md
+++ b/packages/vue/CHANGELOG.md
@@ -3,6 +3,14 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [9.0.7](https://github.com/ionic-team/ionic-framework/compare/v9.0.6...v9.0.7) (2026-10-07)
+
+### Bug Fixes
+
+* **vue-router:** render the redirect target when a guard redirects ([#31510](https://github.com/ionic-team/ionic-framework/issues/31510)) ([643584b](https://github.com/ionic-team/ionic-framework/commit/643584b3ac2ba1ca263cbf53960ccde3be2a96fc))
+* **vue-router:** reset tab with memory history ([#31511](https://github.com/ionic-team/ionic-framework/issues/31511)) ([edbc304](https://github.com/ionic-team/ionic-framework/commit/edbc304fbc4179a668d0e170241abd78311fdb62)), closes [#29785](https://github.com/ionic-team/ionic-framework/issues/29785)
+
+
## [9.0.6](https://github.com/ionic-team/ionic-framework/compare/v9.0.5...v9.0.6) (2026-09-30)
**Note:** Version bump only for package @ionic/vue
diff --git a/packages/vue/package-lock.json b/packages/vue/package-lock.json
index 21bca88312d..5598ae325bf 100644
--- a/packages/vue/package-lock.json
+++ b/packages/vue/package-lock.json
@@ -1,15 +1,15 @@
{
"name": "@ionic/vue",
- "version": "9.0.6",
+ "version": "9.0.7",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@ionic/vue",
- "version": "9.0.6",
+ "version": "9.0.7",
"license": "MIT",
"dependencies": {
- "@ionic/core": "^9.0.6",
+ "@ionic/core": "^9.0.7",
"@stencil/vue-output-target": "0.14.2",
"ionicons": "^8.0.13"
},
@@ -346,9 +346,9 @@
}
},
"node_modules/@ionic/core": {
- "version": "9.0.5",
- "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.5.tgz",
- "integrity": "sha512-Fo3hC0f7YI3XP0eAUUlm49q00u0OG0z55+EZ+s2YZHCUyNL1xq20JKtiPf79pn2tJ8CAYw4u52x6QcWUkL4P3A==",
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@ionic/core/-/core-9.0.6.tgz",
+ "integrity": "sha512-WWxjOjwKPU75BuEhc42t3n2Tn89YEDe5Pce9kA61w/TlWVM3tqiAYC+qfR9MXmER4pQcST01oM2gftheMzcV6g==",
"license": "MIT",
"dependencies": {
"@stencil/core": "^4.44.2",
diff --git a/packages/vue/package.json b/packages/vue/package.json
index 555d306681a..7ab73cdf1ff 100644
--- a/packages/vue/package.json
+++ b/packages/vue/package.json
@@ -1,6 +1,6 @@
{
"name": "@ionic/vue",
- "version": "9.0.6",
+ "version": "9.0.7",
"description": "Vue specific wrapper for @ionic/core",
"scripts": {
"eslint": "eslint src",
@@ -78,7 +78,7 @@
}
},
"dependencies": {
- "@ionic/core": "^9.0.6",
+ "@ionic/core": "^9.0.7",
"@stencil/vue-output-target": "0.14.2",
"ionicons": "^8.0.13"
},
diff --git a/packages/vue/test/base/tests/unit/memory.spec.ts b/packages/vue/test/base/tests/unit/memory.spec.ts
index 5a109446f8e..a1a482d482d 100644
--- a/packages/vue/test/base/tests/unit/memory.spec.ts
+++ b/packages/vue/test/base/tests/unit/memory.spec.ts
@@ -10,6 +10,9 @@ import {
IonApp,
IonRouterOutlet,
IonPage,
+ IonTabs,
+ IonTabBar,
+ IonTabButton,
} from '@ionic/vue';
import { waitForRouter } from './utils';
@@ -112,4 +115,115 @@ describe('createMemoryHistory', () => {
await waitForRouter();
expect(router.currentRoute.value.path).toBe('/page3');
});
+
+ // Verifies fix for https://github.com/ionic-team/ionic-framework/issues/29785
+ describe('tapping the active tab', () => {
+ const Tabs = {
+ components: { IonPage, IonTabs, IonTabBar, IonTabButton, IonRouterOutlet },
+ template: `
+
+
+
+
+ Tab 1
+ Tab 2
+
+
+
+ `,
+ };
+ const Tab1 = {
+ components: { IonPage },
+ template: 'Tab 1',
+ };
+ const Tab1Child = {
+ components: { IonPage },
+ template: 'Tab 1 Child',
+ };
+ const Tab2 = {
+ components: { IonPage },
+ template: 'Tab 2',
+ };
+
+ const createTabsRouter = () =>
+ createRouter({
+ history: createMemoryHistory(process.env.BASE_URL),
+ routes: [
+ { path: '/', redirect: '/tabs/tab1' },
+ {
+ path: '/tabs/',
+ component: Tabs,
+ children: [
+ { path: 'tab1', component: Tab1 },
+ { path: 'tab1/child', component: Tab1Child },
+ { path: 'tab2', component: Tab2 },
+ ],
+ },
+ ],
+ });
+
+ const tapTab = async (wrapper: ReturnType, tab: string) => {
+ const button = wrapper
+ .findAllComponents(IonTabButton)
+ .find((b) => b.props('tab') === tab)!;
+ await button.trigger('click');
+ await waitForRouter();
+ };
+
+ it('should return to the tab root from a child page', async () => {
+ const router = createTabsRouter();
+
+ router.push('/tabs/tab1');
+ await router.isReady();
+ const wrapper = mount(App, {
+ global: { plugins: [router, IonicVue] },
+ });
+ await waitForRouter();
+
+ router.push('/tabs/tab1/child');
+ await waitForRouter();
+ expect(router.currentRoute.value.path).toBe('/tabs/tab1/child');
+
+ await tapTab(wrapper, 'tab1');
+
+ expect(router.currentRoute.value.path).toBe('/tabs/tab1');
+ });
+
+ it('should return to the tab root when the app started on a child page', async () => {
+ const router = createTabsRouter();
+
+ router.push('/tabs/tab1/child');
+ await router.isReady();
+ const wrapper = mount(App, {
+ global: { plugins: [router, IonicVue] },
+ });
+ await waitForRouter();
+
+ await tapTab(wrapper, 'tab1');
+
+ expect(router.currentRoute.value.path).toBe('/tabs/tab1');
+ });
+
+ it('should replace the child page entry rather than push over it', async () => {
+ const router = createTabsRouter();
+
+ router.push('/tabs/tab1');
+ await router.isReady();
+ const wrapper = mount(App, {
+ global: { plugins: [router, IonicVue] },
+ });
+ await waitForRouter();
+
+ router.push('/tabs/tab1/child');
+ await waitForRouter();
+
+ await tapTab(wrapper, 'tab1');
+ expect(router.currentRoute.value.path).toBe('/tabs/tab1');
+
+ router.back();
+ await waitForRouter();
+
+ expect(router.currentRoute.value.path).toBe('/tabs/tab1');
+ });
+ });
})
diff --git a/packages/vue/test/base/tests/unit/routing.spec.ts b/packages/vue/test/base/tests/unit/routing.spec.ts
index dcb7d39c6de..ffa5985f4ea 100644
--- a/packages/vue/test/base/tests/unit/routing.spec.ts
+++ b/packages/vue/test/base/tests/unit/routing.spec.ts
@@ -75,6 +75,16 @@ const waitUntil = async (predicate: () => boolean, label: string) => {
throw new Error(`timed out waiting for ${label}`);
};
+/*
+ * A redirect ends a navigation somewhere other than where it started, so wait
+ * for the path it should end on before letting the router settle.
+ */
+const navigateTo = async (router: any, path: string, navigate: () => void) => {
+ navigate();
+ await waitUntil(() => router.currentRoute.value.path === path, `the navigation to ${path}`);
+ await waitForRouter();
+};
+
describe('Routing', () => {
it('should pass no props', async () => {
const Page1 = {
@@ -1609,6 +1619,304 @@ describe('Routing', () => {
]);
});
+ const mountBackRedirect = async () => {
+ let navManager: any;
+
+ const Home = {
+ ...createPage('home'),
+ setup() {
+ navManager = inject('navManager');
+ }
+ };
+
+ const router = createRouter({
+ history: createWebHistory(process.env.BASE_URL),
+ routes: [
+ { path: '/', redirect: '/home' },
+ { path: '/home', component: Home },
+ { path: '/login', component: createPage('login') },
+ { path: '/profile', component: createPage('profile') }
+ ]
+ });
+
+ router.beforeEach((to, from) => {
+ if (from.path === '/profile' && to.path === '/home') {
+ return '/login';
+ }
+
+ return true;
+ });
+
+ router.push('/');
+ await router.isReady();
+ const wrapper = mount(IonRouterOutlet, {
+ global: {
+ plugins: [router, IonicVue]
+ }
+ });
+
+ router.push('/profile');
+ await waitForRouter();
+
+ return { router, navManager, wrapper };
+ };
+
+ it('should show the redirect target when a guard redirects a browser back', async () => {
+ const { router, navManager, wrapper } = await mountBackRedirect();
+
+ await navigateTo(router, '/login', () => router.back());
+
+ expect(currentRoute(navManager)).toEqual({
+ pathname: '/login',
+ routerAction: 'push',
+ routerDirection: 'forward'
+ });
+ expect(viewStack(wrapper)).toEqual([
+ { id: 'home', hidden: true },
+ { id: 'profile', hidden: true },
+ { id: 'login', hidden: false }
+ ]);
+ });
+
+ it('should show the redirect target when a guard redirects a back button navigation', async () => {
+ const { router, navManager, wrapper } = await mountBackRedirect();
+
+ /*
+ * The back button stages the Home route it expects to go back to, which
+ * Login would inherit if it were carried over.
+ */
+ await navigateTo(router, '/login', () => navManager.handleNavigateBack());
+
+ expect(currentRoute(navManager)).toEqual({
+ pathname: '/login',
+ routerAction: 'push',
+ routerDirection: 'forward'
+ });
+ expect(viewStack(wrapper)).toEqual([
+ { id: 'home', hidden: true },
+ { id: 'profile', hidden: true },
+ { id: 'login', hidden: false }
+ ]);
+ });
+
+ it('should go back normally after a guard redirects a browser back', async () => {
+ const { router, navManager, wrapper } = await mountBackRedirect();
+
+ await navigateTo(router, '/login', () => router.back());
+
+ // The redirect replaced Profile's history entry, so back lands on Home.
+ await navigateTo(router, '/home', () => router.back());
+
+ expect(currentRoute(navManager)).toEqual({
+ pathname: '/home',
+ routerAction: 'pop',
+ routerDirection: 'back'
+ });
+ expect(viewStack(wrapper)).toEqual([
+ { id: 'home', hidden: false },
+ { id: 'profile', hidden: true }
+ ]);
+ });
+
+ /*
+ * Leave guards run before any global guard, so Ionic never sees the
+ * navigation they redirect start.
+ */
+ const mountLeaveRedirect = async () => {
+ let navManager: any;
+
+ const Home = {
+ ...createPage('home'),
+ setup() {
+ navManager = inject('navManager');
+ }
+ };
+ const Profile = {
+ ...createPage('profile'),
+ setup() {
+ onBeforeRouteLeave((to) => (to.path === '/home' ? '/login' : true));
+ }
+ };
+
+ const router = createRouter({
+ history: createWebHistory(process.env.BASE_URL),
+ routes: [
+ { path: '/', redirect: '/home' },
+ { path: '/home', component: Home },
+ { path: '/login', component: createPage('login') },
+ { path: '/profile', component: Profile }
+ ]
+ });
+
+ router.push('/');
+ await router.isReady();
+ const wrapper = mount(IonRouterOutlet, {
+ global: {
+ plugins: [router, IonicVue]
+ }
+ });
+
+ router.push('/profile');
+ await waitForRouter();
+
+ return { router, navManager, wrapper };
+ };
+
+ it('should show the redirect target when a leave guard redirects a browser back', async () => {
+ const { router, navManager, wrapper } = await mountLeaveRedirect();
+
+ await navigateTo(router, '/login', () => router.back());
+
+ expect(currentRoute(navManager)).toEqual({
+ pathname: '/login',
+ routerAction: 'push',
+ routerDirection: 'forward'
+ });
+ expect(viewStack(wrapper)).toEqual([
+ { id: 'home', hidden: true },
+ { id: 'profile', hidden: true },
+ { id: 'login', hidden: false }
+ ]);
+ });
+
+ it('should show the redirect target when a leave guard redirects a back button navigation', async () => {
+ const { router, navManager, wrapper } = await mountLeaveRedirect();
+
+ await navigateTo(router, '/login', () => navManager.handleNavigateBack());
+
+ expect(currentRoute(navManager)).toEqual({
+ pathname: '/login',
+ routerAction: 'push',
+ routerDirection: 'forward'
+ });
+ expect(viewStack(wrapper)).toEqual([
+ { id: 'home', hidden: true },
+ { id: 'profile', hidden: true },
+ { id: 'login', hidden: false }
+ ]);
+ });
+
+ /*
+ * Only a navigation that no guard redirected should keep the root direction,
+ * including one that a `redirect:` record redirected.
+ */
+ const mountRootRedirect = async () => {
+ let navManager: any;
+
+ const Home = {
+ ...createPage('home'),
+ setup() {
+ navManager = inject('navManager');
+ }
+ };
+
+ const router = createRouter({
+ history: createWebHistory(process.env.BASE_URL),
+ routes: [
+ { path: '/', redirect: '/home' },
+ { path: '/home', component: Home },
+ { path: '/login', component: createPage('login') },
+ { path: '/dashboard', component: createPage('dashboard') },
+ { path: '/tabs', redirect: '/tabs/tab' },
+ { path: '/tabs/tab', component: createPage('tab') },
+ { path: '/admin', redirect: '/admin/users' },
+ { path: '/admin/users', component: createPage('users') }
+ ]
+ });
+
+ router.beforeEach((to) => {
+ if (to.path === '/dashboard' || to.path === '/admin/users') {
+ return '/login';
+ }
+
+ return true;
+ });
+
+ router.push('/');
+ await router.isReady();
+ const wrapper = mount(IonRouterOutlet, {
+ global: {
+ plugins: [router, IonicVue]
+ }
+ });
+
+ return { router, navManager, wrapper };
+ };
+
+ it('should not apply the params of a guard redirected navigation to the redirect target', async () => {
+ const { router, navManager, wrapper } = await mountRootRedirect();
+
+ // If it were carried over, the root direction would drop Home from the back stack.
+ await navigateTo(router, '/login', () => navManager.handleNavigate('/dashboard', 'push', 'root'));
+
+ expect(currentRoute(navManager)).toEqual({
+ pathname: '/login',
+ routerAction: 'push',
+ routerDirection: 'forward'
+ });
+ expect(navManager.canGoBack()).toBe(true);
+ expect(viewStack(wrapper)).toEqual([
+ { id: 'home', hidden: true },
+ { id: 'login', hidden: false }
+ ]);
+ });
+
+ // Guards against clearing the params of a navigation that only a route record redirected.
+ it('should keep the params of a navigation redirected by a route record', async () => {
+ const { router, navManager, wrapper } = await mountRootRedirect();
+
+ await navigateTo(router, '/tabs/tab', () => navManager.handleNavigate('/tabs', 'push', 'root'));
+
+ expect(currentRoute(navManager)).toEqual({
+ pathname: '/tabs/tab',
+ routerAction: 'push',
+ routerDirection: 'root'
+ });
+ expect(navManager.canGoBack()).toBe(false);
+ expect(viewStack(wrapper)).toEqual([{ id: 'tab', hidden: false }]);
+ });
+
+ it('should not apply the params when a guard redirects after a route record', async () => {
+ const { router, navManager, wrapper } = await mountRootRedirect();
+
+ await navigateTo(router, '/login', () => navManager.handleNavigate('/admin', 'push', 'root'));
+
+ expect(currentRoute(navManager)).toEqual({
+ pathname: '/login',
+ routerAction: 'push',
+ routerDirection: 'forward'
+ });
+ expect(navManager.canGoBack()).toBe(true);
+ expect(viewStack(wrapper)).toEqual([
+ { id: 'home', hidden: true },
+ { id: 'login', hidden: false }
+ ]);
+ });
+
+ it('should not apply the params when a guard redirects to the current page', async () => {
+ const { router, navManager, wrapper } = await mountRootRedirect();
+
+ await navigateTo(router, '/login', () => router.push('/login'));
+
+ // The guard sends it back to Login, where the router already is, so it fails as a duplicate.
+ navManager.handleNavigate('/dashboard', 'push', 'root');
+ await waitForRouter();
+
+ await navigateTo(router, '/tabs/tab', () => router.push('/tabs'));
+
+ expect(currentRoute(navManager)).toEqual({
+ pathname: '/tabs/tab',
+ routerAction: 'push',
+ routerDirection: 'forward'
+ });
+ expect(navManager.canGoBack()).toBe(true);
+ expect(viewStack(wrapper)).toEqual([
+ { id: 'home', hidden: true },
+ { id: 'login', hidden: true },
+ { id: 'tab', hidden: false }
+ ]);
+ });
+
/*
* Registering an error handler stops vue-router logging an uncaught
* navigation error itself, so these cover the log still reaching an app that
diff --git a/renovate.json5 b/renovate.json5
index d50c442adff..a80ede4ac17 100644
--- a/renovate.json5
+++ b/renovate.json5
@@ -60,6 +60,25 @@
*/
minimumReleaseAge: "3 days"
},
+ {
+ /**
+ * Automerge minor and patch updates once CI passes. Majors still need
+ * a review. With platformAutomerge off, Renovate merges the PR itself
+ * and waits for every check, including ones that aren't required.
+ */
+ matchPackageNames: [
+ "vitest",
+ "@playwright/test",
+ "@axe-core/playwright",
+ "playwright-core",
+ "@types/node",
+ "github/codeql-action",
+ "actions/*"
+ ],
+ matchUpdateTypes: ["minor", "patch"],
+ automerge: true,
+ platformAutomerge: false
+ },
{
/**
* The built-in Docker manager tracks the mcr.microsoft.com/playwright tag