useSendEmailVerification
hook
useSendEmailVerification
hook is used to send email verification to a user. A very simple example would be:
const { dispatch } = useSendEmailVerification(auth);
await dispatch();
Warning
useSendEmailVerification
is lazy by default and will not do anything until you use dispatch
function.
You can also get the state of the process.
const { state, dispatch } = useSendEmailVerification(auth);
await dispatch();
// `state` is "ready" | "loading" | "done" | "anonymous"
Warning
useSendEmailVerification
automatically listens to authentication state and will be "anonymous"
if the user has not signed in. In "anonymous"
state (or any state other than "ready"
to be exact), dispatch
will simply do nothing even if it is invoked.
Input Parameters
Input parameters for useSendEmailVerification
hook is as follows:
Name | Type | Description | Required | Default Value |
---|---|---|---|---|
auth |
firebase/auth/Auth |
Reference to the Firebase Auth service instance. | ✅ | - |
Return Type
useSendEmailVerification
hook returns an object with properties as below:
Name | Type | Description |
---|---|---|
state |
"ready" | "loading" | "done" | "anonymous" |
The state of the process. |
dispatch |
(actionCodeSetting: ActionCodeSetting | undefined) => Promise<void> |
A callback to start the process. |
You can provide an ActionCodeSettings instance to the dispatch
method.