mirror of
https://github.com/bulwarkmail/webmail.git
synced 2026-10-31 16:13:15 +00:00
The browser reads document.title back with its whitespace stripped and collapsed, so a title with two spaces in a row, a tab or a space at the edge never reads back as written. useDocumentTitle put its title back on every <head> mutation whenever the two differed, and its own write was such a mutation: an endless loop that froze the tab at full CPU, for example on opening a message whose subject has two spaces in a row. It now also accepts what the browser read back after its own write.
62 lines
2.6 KiB
TypeScript
62 lines
2.6 KiB
TypeScript
"use client";
|
|
|
|
import { useEffect } from 'react';
|
|
import { useConfig } from '@/hooks/use-config';
|
|
import { useIsFocusedProTab, usePaneId } from '@/hooks/use-pane-context';
|
|
import { useAccountStore } from '@/stores/account-store';
|
|
import { formatTabTitle } from '@/lib/tab-title';
|
|
|
|
// The surface that set the title last owns it. One that is still mounted
|
|
// (during a route transition) stops re-applying, so two titles never fight.
|
|
let owner: symbol | null = null;
|
|
|
|
/**
|
|
* Sets the browser-tab title for a surface: "<context> - <account> - <app>"
|
|
* (see formatTabTitle). Pass a context that is already localized, or nothing
|
|
* for a surface that has nothing to add.
|
|
*
|
|
* Next renders the root layout's metadata <title> again on every client-side
|
|
* navigation, after the new surface has mounted, which puts the bare app name
|
|
* back. So the title is re-applied whenever <head> changes and it is not ours.
|
|
*/
|
|
export function useDocumentTitle(context?: string | null): void {
|
|
const { appName } = useConfig();
|
|
// The account actually in view, so two windows on two accounts stay apart.
|
|
const account = useAccountStore(
|
|
(s) => s.accounts.find((a) => a.id === s.activeAccountId)?.email || null,
|
|
);
|
|
const title = formatTabTitle(context, account, appName);
|
|
// The Pro shell keeps every opened tab mounted (hidden), so only the
|
|
// focused tab may claim the title; outside Pro every surface is in view.
|
|
const paneId = usePaneId();
|
|
const focusedProTab = useIsFocusedProTab();
|
|
const inView = paneId === null || focusedProTab;
|
|
|
|
useEffect(() => {
|
|
if (!inView) return;
|
|
const self = Symbol('document-title');
|
|
owner = self;
|
|
// Setting the title is itself a <head> mutation. The browser reads it
|
|
// back with its whitespace stripped and collapsed (HTML's "strip and
|
|
// collapse ASCII whitespace"), so a subject with two spaces in a row
|
|
// never reads back as written. Comparing with what it read back after
|
|
// our own write ends the round; without that, every write set off the
|
|
// observer again, an endless loop that froze the tab.
|
|
let readBack: string | null = null;
|
|
const apply = () => {
|
|
if (owner !== self) return;
|
|
const current = document.title;
|
|
if (current === title || current === readBack) return;
|
|
document.title = title;
|
|
readBack = document.title;
|
|
};
|
|
apply();
|
|
const observer = new MutationObserver(apply);
|
|
observer.observe(document.head, { childList: true, subtree: true, characterData: true });
|
|
return () => {
|
|
observer.disconnect();
|
|
if (owner === self) owner = null;
|
|
};
|
|
}, [title, inView]);
|
|
}
|