Function createForm

src/FinalForm.ts:166–1438

(config: Config<FormValues, InitialFormValues>)

}

function createForm<
  FormValues = Record<string, any>,
  InitialFormValues extends Partial<FormValues> = Partial<FormValues>
>(config: Config<FormValues, InitialFormValues>): FormApi<FormValues, InitialFormValues> {
  if (!config) {
    throw new Error("No config specified");
  }
  let {
    debug,
    destroyOnUnregister,
    keepDirtyOnReinitialize,
    initialValues,
    mutators,
    onSubmit,
    validate,
    validateOnBlur,
    callbackScheduler,
    ignoreUnregister,
  } = config;
  if (!onSubmit) {
    throw new Error("No onSubmit function specified");
  }

  const state: InternalState<FormValues, InitialFormValues> = {
    subscribers: { index: 0, entries: {} },
    fieldSubscribers: Object.create(null),
    fields: Object.create(null),
    formState: {
      asyncErrors: {},
      dirtySinceLastSubmit: false,
      modifiedSinceLastSubmit: false,
      errors: {},
      initialValues: initialValues && { ...initialValues } as InitialFormValues,

      pristine: true,
      submitting: false,
      submitFailed: false,
      submitSucceeded: false,
      resetWhileSubmitting: false,
      valid: true,
      validating: 0,
      values: (initialValues ? { ...initialValues } : {}) as FormValues,
    },
    lastFormState: undefined,
  };
  let inBatch = 0;
  let validationPaused = false;
  let validationBlocked = false;
  let preventNotificationWhileValidationPaused = false;
  let nextAsyncValidationKey = 0;
  let nextFieldInstanceId = 0;
  const asyncValidationPromises: { [key: number]: Promise<any> } = {};
  const pendingAsyncCallbacks: (() => void)[] = [];
  let asyncCallbacksScheduled = false;
  const clearAsyncValidationPromise = (key: number) => (result: any) => {
    delete asyncValidationPromises[key];
    return result;
  };