@auth0/auth0-acul-js - v1.0.0
    Preparing search index...

    Class Consent

    ConsentMembers

    Hierarchy

    • BaseContext
      • Consent

    Implements

    Index

    Constructors

    constructor

    Properties

    branding client organization prompt screen tenant transaction untrustedData user screenIdentifier

    Methods - Language

    changeLanguage

    Methods - Other

    accept deny getErrors

    Constructors

    • Creates an instance of the Consent screen manager. The constructor initializes the BaseContext and sets up the screen property with an instance of ScreenOverride tailored for the consent screen.

      Returns Consent

      If the Universal Login Context is not available or if the current screen name in the context does not match Consent.screenIdentifier.

    Properties

    branding: Screens.BrandingMembers
    client: Screens.ClientMembers
    organization: Screens.OrganizationMembers
    prompt: Screens.PromptMembers
    screen: Screens.ScreenMembersOnConsent

    Holds the specific screen data and properties for the Consent screen, processed by ScreenOverride. This includes the list of scopes being requested and the hideScopes flag.

    tenant: Screens.TenantMembers
    transaction: Screens.TransactionMembers
    untrustedData: Screens.UntrustedDataMembers
    user: Screens.UserMembers
    screenIdentifier: string = ScreenIds.CONSENT

    Methods - Language

    • Utility Feature

      Changes the language/locale for the current authentication flow.

      This method triggers a language change by submitting the new locale preference to the server with the 'change-language' action. The language change will cause the current screen to re-render with the new locale.

      Parameters

      • options: Screens.LanguageChangeOptions

        Language change options including the target language code

        Options for changing the language/locale during the authentication flow

        • [key: string]: string | number | boolean | undefined

          Additional custom fields to be submitted along with the language change. Custom fields should be prefixed with 'ulp-'.

        • language: string

          Short language name (locale code) to be set (e.g., 'en', 'fr', 'es').

        • Optionalpersist?: "session"

          Defines persistence scope for the language preference. Currently only 'session' is supported.

          'session'

      Returns Promise<void>

      A promise that resolves when the form submission is complete

      import LoginId from "@auth0/auth0-acul-js/login-id";

      const loginManager = new LoginId();

      // Change language to French
      await loginManager.changeLanguage({
        language: 'fr',
        persist: 'session'
      });

      import LoginPassword from "@auth0/auth0-acul-js/login-password";

      const loginPasswordManager = new LoginPassword();

      // Change language to Spanish with additional custom data
      await loginPasswordManager.changeLanguage({
        language: 'es',
        persist: 'session',
        'ulp-custom-field': 'custom-value'
      });
      • This method is available on all screen instances that extend BaseContext
      • The language must be one of the enabled locales configured in your Auth0 tenant
      • The screen will automatically re-render with the new language after submission
      • Custom fields can be included and will be accessible in the Post Login Trigger

    Methods - Other

    • Submits the user's decision to accept (grant) the requested permissions. This method prepares and posts form data to the /u/consent?state=<transaction_state> endpoint with action: "accept". The transaction state is automatically included in both the URL query parameter and the form body.

      Parameters

      • Optionalpayload: Screens.CustomOptions

        Optional. An object for any custom key-value pairs to be sent with the request. These parameters will be included in the form data submitted to the server.

      Returns Promise<void>

      A promise that resolves once the form submission is initiated. Typically, a successful submission leads to a server-side redirect.

      Throws an error if FormHandler encounters an unrecoverable issue during submission (e.g., network error). Server-side validation errors from Auth0 (like "invalid_request") are not thrown as JavaScript errors but are made available in this.transaction.errors after the operation.

      import Consent from '@auth0/auth0-acul-js/consent';
      const consentManager = new Consent();
      const handleAccept = async () => {
       try {
         await consentManager.accept();
         console.log('Consent accepted successfully.');
       } catch (err) {
         console.error('Error accepting consent:', err);
       }
      };

    • Submits the user's decision to deny (reject) the requested permissions. This method prepares and posts form data to the /u/consent?state=<transaction_state> endpoint with action: "deny". The transaction state is automatically included in both the URL query parameter and the form body.

      Parameters

      • Optionalpayload: Screens.CustomOptions

        Optional. An object for any custom key-value pairs to be sent with the request. These parameters will be included in the form data submitted to the server.

      Returns Promise<void>

      A promise that resolves once the form submission is initiated. A successful submission usually results in a server-side redirect.

      Throws an error if FormHandler encounters an issue (e.g., network error). Server-side validation errors are reflected in this.transaction.errors.

      import Consent from '@auth0/auth0-acul-js/consent';
      const consentManager = new Consent();
      const handleDeny = async () => {
       try {
         await consentManager.deny();
         console.log('Form denied successfully.');
       } catch (err) {
         console.error('Failed to deny form:', error);
       }

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods - Language
    Methods - Other