file

Файл из <input type="file"> или FormData: размер и тип.

Сигнатура

function file(options?: { maxSize?: number; types?: string[] }, msg?: Message): Schema<File>

Параметры

Параметр	Тип	Описание
options.maxSize	number	Максимальный размер в байтах: 2 * 1024 * 1024
options.types	string[]	MIME-типы, группы и расширения: ['image/*', 'application/pdf', '.docx']
msg	Message	Своё сообщение для всех ошибок файла

Коды ошибок

Код	Когда	Сообщение по умолчанию
required	Значение пустое, а поле обязательно	Required
file	Не файл	Must be a file
fileSize	Файл больше maxSize	File must be at most {max}
fileType	Тип не из списка	File type must be one of: {types}

Тексты можно поменять: см. Сообщения и локализация.

Особенности

• Работает в браузере и в Node 20+ — там File приходит из FormData (request.formData() в fetch, Hono, Nuxt).
• В сообщении {max} — размер в читаемом виде: 2 MB. В params ошибки есть и size — размер файла.
• Расширения сравниваются без учёта регистра: .pdf пропустит DOC.PDF.
• Несколько файлов — array с maxLength.

Примеры

Аватар

const avatar = file({ maxSize: 2 * 1024 * 1024, types: ['image/*'] });

Несколько документов

const Application = object({
  documents: pipe(array(file({ types: ['application/pdf', '.docx'] })), minLength(1), maxLength(5)),
});

На сервере

app.post('/upload', async (c) => {
  const form = Object.fromEntries(await c.req.formData());
  const { avatar } = parse(object({ avatar: file({ maxSize: 2 * 1024 * 1024 }) }), form);
});

См. также

• array
• maxLength