`navigateOrCall`

(no submodules)

Purpose

navigateOrCall(target) is the canonical helper used by every form component in this package to act on a "URL or click handler" prop. The forms accept string | (() => void) | undefined for affordances like onForgotPassword, onRegister, onLogin, etc. This helper centralises the three-branch routing so each form does not carry an inline copy of the same logic. Treating string values as URLs and function values as imperative handlers lets consumers wire either a static href or an in-app router callback without changing the component prop signature.

Features

String target → window.location.href = target (no-op outside a browser).
Function target → invoke directly.
undefined → no-op.

Usage: Basic

navigateOrCall("/login");
navigateOrCall(() => router.push("/login"));
navigateOrCall(undefined);

Usage: Advanced

<button onClick={() => navigateOrCall(props.onLogin)}>
    Sign in
</button>

API Reference

navigateOrCall(target: string | (() => void) | undefined): void — never throws; safely handles non-browser environments by detecting typeof window.

Implementation Notes

The string branch checks typeof window !== "undefined" so a server-side or test environment that lacks window does not crash. The helper does not return the target — callers cannot observe whether the navigation ran; this matches the imperative redirect semantics expected at every call site.

1.5 KiB Raw Blame History

navigateOrCall