NavigateFunction
The callback returned by useNavigate.
Compatibility
ReactAvailable in this renderer's browser integration.
React SSRAvailable to this renderer's SSR integration; browser event handlers run after hydration.
PreactAvailable in this renderer's browser integration.
Preact SSRAvailable to this renderer's SSR integration; browser event handlers run after hydration.
Import from @kasperrt/smolter/react @kasperrt/smolter/preact
Signature
type NavigateFunction = (
to: string | number | Partial<Pick<URL, "pathname" | "search" | "hash">>,
options?: NavigateOptions,
) => void;Contract
Accepts a string URL, a numeric history delta, or a partial URL containing pathname, search, and hash. A second NavigateOptions argument controls URL navigation. Returns void.
import type { NavigateFunction } from "@kasperrt/smolter/preact";
export function clearFragment(navigate: NavigateFunction): void {
navigate({ hash: "" }, { replace: true });
}Usage and limits
Missing fields in a partial URL retain their current values. Numeric history navigation requires a browser and ignores the options argument. Use router.navigate when an awaitable navigation promise is needed.