@clerk/nextjs
Version:
Clerk SDK for NextJS
26 lines • 1.03 kB
TypeScript
import type { User } from '@clerk/backend';
/**
* The `currentUser` helper returns the [Backend User](https://clerk.com/docs/references/backend/types/backend-user) object of the currently active user. It can be used in Server Components, Route Handlers, and Server Actions.
*
* Under the hood, this helper:
* - calls `fetch()`, so it is automatically deduped per request.
* - uses the [`GET /v1/users/{user_id}`](https://clerk.com/docs/reference/backend-api/tag/Users#operation/GetUser) endpoint.
* - counts towards the [Backend API request rate limit](https://clerk.com/docs/backend-requests/resources/rate-limits#rate-limits).
*
* @example
* ```tsx
* // app/page.tsx
*
* import { currentUser } from '@clerk/nextjs/server'
*
* export default async function Page() {
* const user = await currentUser()
*
* if (!user) return <div>Not signed in</div>
*
* return <div>Hello {user?.firstName}</div>
* }
* ```
*/
export declare function currentUser(): Promise<User | null>;
//# sourceMappingURL=currentUser.d.ts.map