@auth0/auth0-react
    Preparing search index...

    Interface Auth0ContextInterface<TUser>

    Contains the authenticated state and authentication methods provided by the useAuth0 hook.

    interface Auth0ContextInterface<TUser extends User = User> {
        connectAccountWithRedirect: (
            options: RedirectConnectAccountOptions,
        ) => Promise<void>;
        createFetcher: <TOutput extends CustomFetchMinimalOutput = Response>(
            config?: FetcherConfig<TOutput>,
        ) => Fetcher<TOutput>;
        error: undefined | Error;
        generateDpopProof: (
            params: {
                accessToken: string;
                method: string;
                nonce?: string;
                url: string;
            },
        ) => Promise<string>;
        getAccessTokenSilently: {
            (
                options: GetTokenSilentlyOptions & { detailedResponse: true },
            ): Promise<GetTokenSilentlyVerboseResponse>;
            (options?: GetTokenSilentlyOptions): Promise<string>;
            (
                options: GetTokenSilentlyOptions,
            ): Promise<string | GetTokenSilentlyVerboseResponse>;
        };
        getAccessTokenWithPopup: (
            options?: GetTokenWithPopupOptions,
            config?: PopupConfigOptions,
        ) => Promise<undefined | string>;
        getDpopNonce: (id?: string) => Promise<undefined | string>;
        getIdTokenClaims: () => Promise<undefined | IdToken>;
        handleRedirectCallback: (
            url?: string,
        ) => Promise<ConnectAccountRedirectResult | RedirectLoginResult<any>>;
        isAuthenticated: boolean;
        isLoading: boolean;
        loginWithPopup: (
            options?: PopupLoginOptions,
            config?: PopupConfigOptions,
        ) => Promise<void>;
        loginWithRedirect: (
            options?: RedirectLoginOptions<AppState>,
        ) => Promise<void>;
        logout: (options?: LogoutOptions) => Promise<void>;
        setDpopNonce: (nonce: string, id?: string) => Promise<void>;
        user: undefined | TUser;
    }

    Type Parameters

    Hierarchy

    • AuthState<TUser>
      • Auth0ContextInterface
    Index

    Properties

    connectAccountWithRedirect createFetcher error generateDpopProof getAccessTokenSilently getAccessTokenWithPopup getDpopNonce getIdTokenClaims handleRedirectCallback isAuthenticated isLoading loginWithPopup loginWithRedirect logout setDpopNonce user

    Properties

    connectAccountWithRedirect: (
        options: RedirectConnectAccountOptions,
    ) => Promise<void>
    await connectAccountWithRedirect({
      connection: 'google-oauth2',
      authorizationParams: {
        access_type: 'offline',
        scope: 'openid profile email https://www.googleapis.com/auth/drive.readonly',
      }
    });

    Redirects to the /connect URL using the parameters provided as arguments. This then redirects to the connection's login page where the user can authenticate and authorize the account to be connected.

    If connecting the account is successful onRedirectCallback will be called with the details of the connected account.

    createFetcher: <TOutput extends CustomFetchMinimalOutput = Response>(
        config?: FetcherConfig<TOutput>,
    ) => Fetcher<TOutput>

    Returns a new Fetcher class that will contain a fetchWithAuth() method. This is a drop-in replacement for the Fetch API's fetch() method, but will handle certain authentication logic for you, like building the proper auth headers or managing DPoP nonces and retries automatically.

    Check the EXAMPLES.md file for a deeper look into this method.

    Type Declaration

      • <TOutput extends CustomFetchMinimalOutput = Response>(
            config?: FetcherConfig<TOutput>,
        ): Fetcher<TOutput>

      • Returns a new Fetcher class that will contain a fetchWithAuth() method. This is a drop-in replacement for the Fetch API's fetch() method, but will handle certain authentication logic for you, like building the proper auth headers or managing DPoP nonces and retries automatically.

        Check the EXAMPLES.md file for a deeper look into this method.

        Type Parameters

        • TOutput extends CustomFetchMinimalOutput = Response

        Parameters

        Returns Fetcher<TOutput>

    error: undefined | Error
    generateDpopProof: (
        params: {
            accessToken: string;
            method: string;
            nonce?: string;
            url: string;
        },
    ) => Promise<string>

    Returns a string to be used to demonstrate possession of the private key used to cryptographically bind access tokens with DPoP.

    It requires enabling the Auth0ClientOptions.useDpop option.

    Type Declaration

      • (
            params: {
                accessToken: string;
                method: string;
                nonce?: string;
                url: string;
            },
        ): Promise<string>

      • Returns a string to be used to demonstrate possession of the private key used to cryptographically bind access tokens with DPoP.

        It requires enabling the Auth0ClientOptions.useDpop option.

        Parameters

        • params: { accessToken: string; method: string; nonce?: string; url: string }

        Returns Promise<string>

    getAccessTokenSilently: {
        (
            options: GetTokenSilentlyOptions & { detailedResponse: true },
        ): Promise<GetTokenSilentlyVerboseResponse>;
        (options?: GetTokenSilentlyOptions): Promise<string>;
        (
            options: GetTokenSilentlyOptions,
        ): Promise<string | GetTokenSilentlyVerboseResponse>;
    }
    const token = await getAccessTokenSilently(options);

    If there's a valid token stored, return it. Otherwise, opens an iframe with the /authorize URL using the parameters provided as arguments. Random and secure state and nonce parameters will be auto-generated. If the response is successful, results will be valid according to their expiration times.

    If refresh tokens are used, the token endpoint is called directly with the 'refresh_token' grant. If no refresh token is available to make this call, the SDK will only fall back to using an iframe to the '/authorize' URL if the useRefreshTokensFallback setting has been set to true. By default this setting is false.

    This method may use a web worker to perform the token call if the in-memory cache is used.

    If an audience value is given to this function, the SDK always falls back to using an iframe to make the token exchange.

    Note that in all cases, falling back to an iframe requires access to the auth0 cookie.

    getAccessTokenWithPopup: (
        options?: GetTokenWithPopupOptions,
        config?: PopupConfigOptions,
    ) => Promise<undefined | string>
    const token = await getTokenWithPopup(options, config);

    Get an access token interactively.

    Opens a popup with the /authorize URL using the parameters provided as arguments. Random and secure state and nonce parameters will be auto-generated. If the response is successful, results will be valid according to their expiration times.

    getDpopNonce: (id?: string) => Promise<undefined | string>

    Returns the current DPoP nonce used for making requests to Auth0.

    It can return undefined because when starting fresh it will not be populated until after the first response from the server.

    It requires enabling the Auth0ClientOptions.useDpop option.

    Type Declaration

      • (id?: string): Promise<undefined | string>

      • Returns the current DPoP nonce used for making requests to Auth0.

        It can return undefined because when starting fresh it will not be populated until after the first response from the server.

        It requires enabling the Auth0ClientOptions.useDpop option.

        Parameters

        • Optionalid: string

          The identifier of a nonce: if absent, it will get the nonce used for requests to Auth0. Otherwise, it will be used to select a specific non-Auth0 nonce.

        Returns Promise<undefined | string>

    The nonce value.

    The identifier of a nonce: if absent, it will get the nonce used for requests to Auth0. Otherwise, it will be used to select a specific non-Auth0 nonce.

    getIdTokenClaims: () => Promise<undefined | IdToken>
    const claims = await getIdTokenClaims();

    Returns all claims from the id_token if available.

    handleRedirectCallback: (
        url?: string,
    ) => Promise<ConnectAccountRedirectResult | RedirectLoginResult<any>>

    After the browser redirects back to the callback page, call handleRedirectCallback to handle success and error responses from Auth0. If the response is successful, results will be valid according to their expiration times.

    Type Declaration

      • (url?: string): Promise<ConnectAccountRedirectResult | RedirectLoginResult<any>>

      • Parameters

        • Optionalurl: string

          The URL to that should be used to retrieve the state and code values. Defaults to window.location.href if not given.

        Returns Promise<ConnectAccountRedirectResult | RedirectLoginResult<any>>

    isAuthenticated: boolean
    isLoading: boolean
    loginWithPopup: (
        options?: PopupLoginOptions,
        config?: PopupConfigOptions,
    ) => Promise<void>
    await loginWithPopup(options, config);

    Opens a popup with the /authorize URL using the parameters provided as arguments. Random and secure state and nonce parameters will be auto-generated. If the response is successful, results will be valid according to their expiration times.

    IMPORTANT: This method has to be called from an event handler that was started by the user like a button click, for example, otherwise the popup will be blocked in most browsers.

    loginWithRedirect: (options?: RedirectLoginOptions<AppState>) => Promise<void>
    await loginWithRedirect(options);

    Performs a redirect to /authorize using the parameters provided as arguments. Random and secure state and nonce parameters will be auto-generated.

    logout: (options?: LogoutOptions) => Promise<void>
    auth0.logout({ logoutParams: { returnTo: window.location.origin } });

    Clears the application session and performs a redirect to /v2/logout, using the parameters provided as arguments, to clear the Auth0 session. If the logoutParams.federated option is specified, it also clears the Identity Provider session. Read more about how Logout works at Auth0.

    setDpopNonce: (nonce: string, id?: string) => Promise<void>

    Sets the current DPoP nonce used for making requests to Auth0.

    It requires enabling the Auth0ClientOptions.useDpop option.

    Type Declaration

      • (nonce: string, id?: string): Promise<void>

      • Sets the current DPoP nonce used for making requests to Auth0.

        It requires enabling the Auth0ClientOptions.useDpop option.

        Parameters

        • nonce: string

          The nonce value.

        • Optionalid: string

          The identifier of a nonce: if absent, it will set the nonce used for requests to Auth0. Otherwise, it will be used to select a specific non-Auth0 nonce.

        Returns Promise<void>

    The nonce value.

    The identifier of a nonce: if absent, it will set the nonce used for requests to Auth0. Otherwise, it will be used to select a specific non-Auth0 nonce.

    user: undefined | TUser

    Settings

    Member Visibility

    On This Page

    Properties