validateFileList

validateFileList function processes a list of uploaded files, validating each file against:

Maximum file size in bytes (if provided)
Accepted file types (based on the accept attribute)

This function utilized by RHFFileUploader ensures only files meeting the required criteria are passed for further processing.

type ValidateFileListOptions = {
  accept?: string,
  maxSize?: number,
  maxFiles?: number
}

type ProcessFilesResult = {
  acceptedFiles: File[];
  rejectedFiles: {
    file: File;
    errors: FileUploadError[];
  }[];
}

function validateFileList(
  fileList: FileList | File[],
  options?: ValidateFileListOptions
): ProcessFilesResult

Usage

import { validateFileList } from '@nish1896/rhf-mui-components/form-helpers';

Parameters

fileList: The set of input files to run this validation against.
options: Validation options used when processing the file list.
- accept — Optional string specifying the allowed file types or extensions, following the standard input[type="file"] accept attribute format (for example, .png, .jpg, image/*). Files that do not match the specified criteria will be added to rejectedFiles.
- maxSize — Optional maximum file size in bytes. Files exceeding this limit will be added to rejectedFiles.
- maxFiles — Optional maximum number of files allowed. If the number of valid files exceeds this limit, the additional files will be added to rejectedFiles with a FILE_LIMIT_EXCEEDED error and excluded from acceptedFiles.

Returns

acceptedFiles — Files that passed validation (File[]).
rejectedFiles — Files that failed validation, along with the reasons for rejection, and is of the type:
```
type FileUploadErrorDetails = {
  /** File that failed validation. */
  file: File;
  /** Validation errors reported for the file. */
  errors: FileUploadError[];
};
```
Possible FileUploadError values:
- FILE_SIZE_EXCEEDED
- FILE_TYPE_NOT_ALLOWED
- FILE_LIMIT_EXCEEDED

Examples

// Allow any file, but max allowed size for each file should be 5 MB.
validateFileList(fileList, { accept: '*', maxSize: 5 * 1024 * 1024 });

// Allow only image mimetype
validateFileList(fileList, { accept: 'image/*' });

// Allow at max 3 files
validateFileList(fileList, { maxFiles: 3 });

fieldNameToLabel

getFileSize