Fix a bug with default_panel option and update Home Assistant to version 2026.8.0b4

Author: elchininet

.hass/config/.HA_VERSION

@@ -1 +1 @@
-2026.8.0b3
+2026.8.0b4

dist/custom-sidebar-plugin.js

@@ -6,7 +6,7 @@ import DocCardList from '@theme/DocCardList';
 
 # Troubleshooting
 
-This plugin counts [with an extensive suite of end-to-end tests](https://github.com/elchininet/custom-sidebar/tree/b080083376cca657bf06d740d3dc30d4fa7c2b32/tests). At the moment of writing, there are 467 tests covering every single option of the plugin and the coverage of the code [is at 100%](https://coveralls.io/github/elchininet/custom-sidebar?branch=master). On top of this, there are also [regression tests through screenshots](https://github.com/elchininet/custom-sidebar/tree/b080083376cca657bf06d740d3dc30d4fa7c2b32/test-snapshots) to check that there are no visual changes when a modification of the code is done. There are also [Nightly Beta Tests](https://github.com/elchininet/custom-sidebar/actions/workflows/ha-beta-tests.yaml) in place that run every night against the [homeassistant/home-assistant:beta tag](https://hub.docker.com/layers/homeassistant/home-assistant/beta/images/) that allows us to detect if any option of the plugin will be broken in the next `Home Assistant` version before that version is released.
+This plugin counts [with an extensive suite of end-to-end tests](https://github.com/elchininet/custom-sidebar/tree/b080083376cca657bf06d740d3dc30d4fa7c2b32/tests). At the moment of writing, there are 468 tests covering every single option of the plugin and the coverage of the code [is at 100%](https://coveralls.io/github/elchininet/custom-sidebar?branch=master). On top of this, there are also [regression tests through screenshots](https://github.com/elchininet/custom-sidebar/tree/b080083376cca657bf06d740d3dc30d4fa7c2b32/test-snapshots) to check that there are no visual changes when a modification of the code is done. There are also [Nightly Beta Tests](https://github.com/elchininet/custom-sidebar/actions/workflows/ha-beta-tests.yaml) in place that run every night against the [homeassistant/home-assistant:beta tag](https://hub.docker.com/layers/homeassistant/home-assistant/beta/images/) that allows us to detect if any option of the plugin will be broken in the next `Home Assistant` version before that version is released.
 
 This means that if you detect that your configuration stopped working suddenly after an update, there are four possible reasons for that:
 

docs/docs/08-troubleshooting/index.mdx

@@ -8,14 +8,48 @@ import {
 } from '@constants';
 import { fireEvent } from './events';
 
-const dispatchLocationChanged = (pathname: string): void => {
-    fireEvent(
-        window,
-        EVENT.LOCATION_CHANGED,
-        {
-            replace: pathname
+const dispatchLocationChanged = (
+    replace: boolean,
+    params: Parameters<typeof window.history.replaceState>
+): void => {
+
+    const fire = () => {
+        fireEvent(
+            window,
+            EVENT.LOCATION_CHANGED,
+            {
+                replace,
+                source: NAMESPACE
+            }
+        );
+    };
+
+    fire();
+
+    // If there is another LOCATION_CHANGED event not originated from custom-sidebar
+    // Within a 100 milliseconds time offset
+    // Cancel it replacing the location with the previous pathname
+    const offset = 100;
+    const time = Date.now();
+    const callback = (event: Event) => {
+        const timeDiff = Date.now() - time;
+        if (
+            timeDiff < offset &&
+            // If it is not a custom-sidebar event
+            (event as CustomEvent).detail?.source !== NAMESPACE
+        ) {
+            window.history.replaceState(...params);
+            fire();
         }
-    );
+    };
+
+    // Listen for events during the offset
+    window.addEventListener(EVENT.LOCATION_CHANGED, callback);
+
+    // Cancel the listener after the offset
+    setTimeout(() => {
+        window.removeEventListener(EVENT.LOCATION_CHANGED, callback);
+    }, offset);
 };
 
 export const navigate = (
@@ -34,18 +68,16 @@ export const navigate = (
         } else {
             window.history.pushState(...params);
         }
-        dispatchLocationChanged(pathname);
+        dispatchLocationChanged(replace, params);
     } else {
         console.warn(`${NAMESPACE}: ${warningMessage} "${pathname}" as it doesn't start with "/".`);
     }
 };
 
 export const buildNavigateMethods = (sidebar: HAElement) => {
-
     return {
         navigate,
         activateItem: async (item: SidebarItem) => {
-
             // Small delay to avoid activating the item before the panel load logic runs
             await new Promise((resolve) => setTimeout(resolve, 5));
             const activeItem = await sidebar.selector.$.query(`${CUSTOM_ELEMENT.ITEM}.${CLASS.ITEM_SELECTED}`).element as HTMLElement;
@@ -55,7 +87,6 @@ export const buildNavigateMethods = (sidebar: HAElement) => {
 
             item.classList.add(CLASS.ITEM_SELECTED);
             item.tabIndex = 0;
-
         }
     };
 };

src/utilities/modules/navigate.ts

@@ -1,6 +1,7 @@
 import { expect, test } from 'playwright-test-coverage';
 import { haConfigRequest } from './ha-services';
 import {
+    BASE_URL,
     CONFIG_FILES,
     HREFS,
     SELECTORS
@@ -448,6 +449,65 @@ test.describe('methods in JavaScript templates', () => {
 
         });
 
+        test('should not execute a location-changed event not originated from custom-sidebar executed withing a 100 milliseconds offset of a navigate method', async ({ page }) => {
+
+            const timeoutOptions = { timeout: 30000 };
+            const toolsPath = '/config/tools/yaml';
+            const toolsUrl = `${BASE_URL}${toolsPath}`;
+
+            await fulfillJson(
+                page,
+                {
+                    order: [
+                        {
+                            ...item,
+                            on_click: {
+                                action: 'javascript',
+                                code: `
+                                    navigate('${toolsPath}')`
+                            }
+                        }
+                    ]
+                }
+            );
+
+            const goToHomeEvent = async (withDetail: boolean) => {
+                return page.evaluate((withDetail: boolean) => {
+                    window.history.replaceState(null, '', '/lovelace');
+                    window.dispatchEvent(
+                        new CustomEvent(
+                            'location-changed',
+                            {
+                                bubbles: true,
+                                cancelable: false,
+                                composed: true,
+                                detail: withDetail
+                                    ? {
+                                        replace: true
+                                    }
+                                    : undefined
+                            }
+                        )
+                    );
+                }, withDetail);
+            };
+
+            await navigateHome(page);
+
+            await getSidebarItem(page, '#').click();
+
+            await goToHomeEvent(true);
+
+            await expect(page.locator(SELECTORS.PANEL_CONFIG)).toBeVisible(timeoutOptions);
+            await expect(page).toHaveURL(toolsUrl, timeoutOptions);
+
+            await goToHomeEvent(false);
+
+            await expect(page.locator(SELECTORS.PANEL_CONFIG)).toBeVisible(timeoutOptions);
+            await expect(page).toHaveURL(toolsUrl, timeoutOptions);
+
+        });
+
     });
 
     test.describe('fireEvent method', () => {