An open source design system that's fully customizable and agent ready
TypeScript
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
* @file FileInput.test.tsx
* @input Uses vitest, @testing-library/react, FileInput component
* @output Unit tests for FileInput component behavior
* @position Testing; validates FileInput.tsx implementation
*
* SYNC: When FileInput.tsx changes, update tests to match new behavior
*/
import {describe, it, expect, vi, afterEach, beforeEach} from 'vitest';
import {
render,
screen,
fireEvent,
createEvent,
waitFor,
act,
within,
} from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import {FileInput} from './FileInput';
import {FormLayout} from '../FormLayout';
import {__resetLiveRegionsForTest} from '../hooks/useAnnounce';
import {InternationalizationProvider} from '../i18n';
import {Theme} from '../theme/Theme';
import {defineTheme} from '../theme/defineTheme';
// The `=1` branch names the file; the `other` branch must not. Both come from
// this test, so neither can pass against a hardcoded English string.
const FILE_SELECTED = 'Un fichier choisi : {fileName}';
const FILES_SELECTED = '{count, number} fichiers choisis';
afterEach(() => {
__resetLiveRegionsForTest();
});
// Mock showPopover/hidePopover since jsdom does not implement them. Used by the
// disabledMessage tooltip.
beforeEach(() => {
HTMLElement.prototype.showPopover = vi.fn(function (this: HTMLElement) {
this.setAttribute('popover-open', '');
const event = new Event('toggle', {bubbles: false});
Object.defineProperty(event, 'newState', {value: 'open'});
this.dispatchEvent(event);
});
HTMLElement.prototype.hidePopover = vi.fn(function (this: HTMLElement) {
this.removeAttribute('popover-open');
const event = new Event('toggle', {bubbles: false});
Object.defineProperty(event, 'newState', {value: 'closed'});
this.dispatchEvent(event);
});
const originalMatches = HTMLElement.prototype.matches;
// eslint-disable-next-line @typescript-eslint/no-explicit-any
(HTMLElement.prototype as any).matches = function (
selector: string,
): boolean {
if (selector === ':popover-open') {
return this.hasAttribute('popover-open');
}
// jsdom does not resolve :focus-visible for role="button" divs the way a
// browser does after keyboard focus; treat the active element as
// focus-visible so the tooltip's keyboard-focus path is exercised.
if (selector === ':focus-visible') {
return this === document.activeElement;
}
return originalMatches.call(this, selector);
};
});
// jsdom popover content is in the DOM but may not be "visible" in the
// accessibility tree. Use hidden: true to find it.
const h = {hidden: true} as const;
function politeRegion(): HTMLElement | null {
return document.querySelector('[data-astryx-live-region="polite"]');
}
function fileInputEl(): HTMLInputElement {
const el = document.querySelector('input[type="file"]');
if (!(el instanceof HTMLInputElement)) {
throw new Error('file input not found');
}
return el;
}
function createFile(
name: string,
size: number,
type: string = 'text/plain',
): File {
const content = new Uint8Array(size);
return new File([content], name, {type});
}
describe('FileInput', () => {
it('renders with label', () => {
render(<FileInput label="Resume" value={null} onChange={() => {}} />);
expect(screen.getByText('Resume')).toBeInTheDocument();
});
it('renders default placeholder for single file', () => {
render(<FileInput label="File" value={null} onChange={() => {}} />);
expect(screen.getByText('Choose file')).toBeInTheDocument();
});
it('renders default placeholder for multiple files', () => {
render(
<FileInput label="Files" value={null} onChange={() => {}} isMultiple />,
);
expect(screen.getByText('Choose files')).toBeInTheDocument();
});
it('renders custom placeholder', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
placeholder="Drop here"
/>,
);
expect(screen.getByText('Drop here')).toBeInTheDocument();
});
it.each([
{mode: 'input' as const, size: 'sm'},
{mode: 'dropzone' as const, size: 'md'},
])(
'uses the shared upload icon registry and preserves the $mode theme target',
({mode, size}) => {
const theme = {
...defineTheme({
name: `file-input-semantic-icon-${mode}`,
icons: {upload: <svg data-testid={`themed-upload-${mode}`} />},
}),
__built: true as const,
};
render(
<Theme theme={theme}>
<FileInput
label="Upload"
mode={mode}
value={null}
onChange={() => {}}
/>
</Theme>,
);
const icon = screen
.getByTestId(`themed-upload-${mode}`)
.closest('.astryx-file-input-icon');
expect(icon).toHaveClass('astryx-icon');
expect(icon).toHaveAttribute('data-mode', mode);
expect(icon).toHaveAttribute('data-size', size);
},
);
it('displays selected file name', () => {
const file = createFile('report.pdf', 1024, 'application/pdf');
render(<FileInput label="Document" value={file} onChange={() => {}} />);
expect(screen.getByText('report.pdf')).toBeInTheDocument();
});
it('displays multiple file names', () => {
const files = [createFile('a.txt', 100), createFile('b.txt', 200)];
render(
<FileInput label="Files" value={files} onChange={() => {}} isMultiple />,
);
expect(screen.getByText('a.txt, b.txt')).toBeInTheDocument();
});
it('forwards ref to the native input', () => {
const ref = vi.fn();
render(
<FileInput ref={ref} label="Upload" value={null} onChange={() => {}} />,
);
expect(ref).toHaveBeenCalledWith(expect.any(HTMLInputElement));
});
it('visually hides label when isLabelHidden is true', () => {
render(
<FileInput
label="Upload"
isLabelHidden
value={null}
onChange={() => {}}
/>,
);
expect(screen.getByText('Upload')).toBeInTheDocument();
});
it('conveys required state through the accessible description', () => {
render(
<FileInput label="Resume" isRequired value={null} onChange={() => {}} />,
);
const trigger = screen.getByRole('button', {name: 'Resume'});
// Required is conveyed via a visually hidden "Required" node referenced
// from aria-describedby on the focusable role="button" trigger — not the
// hidden file input (forms-6).
expect(trigger).toHaveAccessibleDescription(/Required/);
// aria-required is not a supported property of role="button" in
// WAI-ARIA 1.2 (AT does not announce it), so it must never appear.
expect(trigger).not.toHaveAttribute('aria-required');
});
it('conveys required state under FormLayout defaultOptionality="required" unless isOptional (FormLayout FR5)', () => {
render(
<FormLayout defaultOptionality="required">
<FileInput label="Resume" value={null} onChange={() => {}} />
<FileInput
label="Cover letter"
isOptional
value={null}
onChange={() => {}}
/>
</FormLayout>,
);
expect(
screen.getByRole('button', {name: 'Resume'}),
).toHaveAccessibleDescription(/Required/);
expect(
screen.getByRole('button', {name: /Cover letter/}),
).not.toHaveAccessibleDescription(/Required/);
});
it('combines required with the description in the accessible description', () => {
render(
<FileInput
label="Resume"
description="PDF only"
isRequired
value={null}
onChange={() => {}}
/>,
);
const trigger = screen.getByRole('button', {name: 'Resume'});
expect(trigger).toHaveAccessibleDescription(/PDF only/);
expect(trigger).toHaveAccessibleDescription(/Required/);
});
it('places aria-describedby on the focusable button, not the hidden input (forms-6)', () => {
render(
<FileInput
label="Resume"
description="PDF only"
value={null}
onChange={() => {}}
/>,
);
const button = screen.getByRole('button', {name: 'Resume'});
expect(button).toHaveAttribute('aria-describedby');
// The hidden file input no longer carries the describedby/required/invalid.
const input = document.querySelector('input[type="file"]')!;
expect(input).not.toHaveAttribute('aria-describedby');
expect(input).toHaveAttribute('aria-hidden', 'true');
});
it("joins a caller's aria-describedby to the trigger's own description", () => {
render(
<>
<p id="hint">Up to 10 MB</p>
<FileInput
label="Report"
description="PDF only"
aria-describedby="hint"
value={null}
onChange={() => {}}
/>
</>,
);
const trigger = screen.getByRole('button', {name: 'Report'});
expect(trigger).toHaveAccessibleDescription('Up to 10 MB PDF only');
});
it("puts a caller's other aria-* props on the trigger, and keeps the ones it manages", () => {
render(
<FileInput
label="Report"
aria-details="details"
aria-expanded={false}
aria-posinset={1}
aria-label="Ignored"
value={null}
onChange={() => {}}
/>,
);
const trigger = screen.getByRole('button', {name: 'Report'});
expect(trigger).toHaveAttribute('aria-details', 'details');
// Booleans and numbers reach the trigger too.
expect(trigger).toHaveAttribute('aria-expanded', 'false');
expect(trigger).toHaveAttribute('aria-posinset', '1');
expect(trigger).toHaveAttribute('aria-label', 'Report');
// The hidden input is still aria-hidden, whatever props it takes.
expect(document.querySelector('input[type="file"]')).toHaveAttribute(
'aria-hidden',
'true',
);
});
it('does not mention required without isRequired', () => {
render(<FileInput label="Resume" value={null} onChange={() => {}} />);
const trigger = screen.getByRole('button', {name: 'Resume'});
expect(trigger).not.toHaveAccessibleDescription(/Required/);
expect(trigger).not.toHaveAttribute('aria-required');
});
it('keeps a disabled input focusable and out of form submission', async () => {
const user = userEvent.setup();
render(
<form>
<FileInput
label="Upload"
isRequired
isDisabled
value={null}
onChange={() => {}}
/>
</form>,
);
const input =
document.querySelector<HTMLInputElement>('input[type="file"]')!;
const trigger = screen.getByRole('button', {name: 'Upload'});
expect(input).not.toHaveAttribute('disabled');
expect(trigger).not.toHaveAttribute('disabled');
expect(trigger).toHaveAttribute('aria-disabled', 'true');
const openPicker = vi.spyOn(input, 'click');
await user.tab();
expect(trigger).toHaveFocus();
await user.keyboard('{Enter}');
expect(openPicker).not.toHaveBeenCalled();
expect(input.form).toBeNull();
expect(trigger.closest('form')!.checkValidity()).toBe(true);
// A label click activates the hidden input directly; it is canceled so
// the picker never opens (fireEvent returns false when prevented).
expect(fireEvent.click(input)).toBe(false);
});
it('sets aria-invalid when status type is error', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
status={{type: 'error', message: 'Something went wrong'}}
/>,
);
expect(screen.getByRole('button', {name: 'Upload'})).toHaveAttribute(
'aria-invalid',
'true',
);
});
it('does not set aria-invalid for warning status', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
status={{type: 'warning'}}
/>,
);
expect(screen.getByRole('button', {name: 'Upload'})).not.toHaveAttribute(
'aria-invalid',
);
});
it('renders status message when provided', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
status={{type: 'error', message: 'File too large'}}
/>,
);
expect(screen.getByText('File too large')).toBeInTheDocument();
});
it('renders description text', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
description="Max 5MB"
/>,
);
expect(screen.getByText('Max 5MB')).toBeInTheDocument();
});
describe('file selection via native input', () => {
it('calls onChange when a file is selected', () => {
const handleChange = vi.fn();
render(<FileInput label="Upload" value={null} onChange={handleChange} />);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const file = createFile('test.txt', 100);
fireEvent.change(input, {target: {files: [file]}});
expect(handleChange).toHaveBeenCalledWith(file);
});
it('calls onChange with File[] when isMultiple', () => {
const handleChange = vi.fn();
render(
<FileInput
label="Upload"
value={null}
onChange={handleChange}
isMultiple
/>,
);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const files = [createFile('a.txt', 100), createFile('b.txt', 200)];
fireEvent.change(input, {target: {files}});
expect(handleChange).toHaveBeenCalledWith(files);
});
it('sets accept attribute on native input', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
accept=".pdf,.doc"
/>,
);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
expect(input).toHaveAttribute('accept', '.pdf,.doc');
});
it('sets multiple attribute when isMultiple', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
isMultiple
/>,
);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
expect(input).toHaveAttribute('multiple');
});
});
describe('announcements', () => {
it('announces a single file selection politely', async () => {
render(
<InternationalizationProvider
locale="fr"
overrides={{fr: {'@astryx.fileInput.fileSelected': FILE_SELECTED}}}>
<FileInput label="Upload" value={null} onChange={() => {}} />
</InternationalizationProvider>,
);
fireEvent.change(fileInputEl(), {
target: {files: [createFile('report.pdf', 100)]},
});
await waitFor(() => {
// The single-file key, carrying the file name.
expect(politeRegion()?.textContent).toBe(
'Un fichier choisi : report.pdf',
);
});
});
it('announces a multi-file count politely', async () => {
render(
<InternationalizationProvider
locale="fr"
overrides={{fr: {'@astryx.fileInput.filesSelected': FILES_SELECTED}}}>
<FileInput
label="Upload"
value={null}
onChange={() => {}}
isMultiple
/>
</InternationalizationProvider>,
);
const files = [
createFile('a.txt', 100),
createFile('b.txt', 200),
createFile('c.txt', 300),
];
fireEvent.change(fileInputEl(), {target: {files}});
await waitFor(() => {
// The multi-file key: a count, and no file name.
expect(politeRegion()?.textContent).toBe('3 fichiers choisis');
});
expect(politeRegion()?.textContent).not.toContain('a.txt');
});
it('speaks the selection from a provider catalog', async () => {
render(
<InternationalizationProvider
locale="fr"
messages={{
fr: {
'@astryx.fileInput.fileSelected': {defaultMessage: FILE_SELECTED},
},
}}>
<FileInput label="Upload" value={null} onChange={() => {}} />
</InternationalizationProvider>,
);
fireEvent.change(fileInputEl(), {
target: {files: [createFile('report.pdf', 100)]},
});
await waitFor(() => {
// Same key through the catalog path rather than `overrides`.
expect(politeRegion()?.textContent).toBe(
'Un fichier choisi : report.pdf',
);
});
});
it('does not announce a selection when validation rejects all files', async () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
accept=".pdf"
/>,
);
fireEvent.change(fileInputEl(), {
target: {files: [createFile('note.txt', 100)]},
});
// A rejected selection announces nothing politely. (The region pair may
// exist because the validation error itself is announced assertively via
// FieldStatus, but the polite channel must stay empty.)
expect(politeRegion()?.textContent ?? '').toBe('');
});
it('identifies every rejected file in one status message (WCAG 3.3.1)', async () => {
const onChange = vi.fn();
render(
<FileInput
label="Reports"
value={null}
onChange={onChange}
isMultiple
accept=".pdf"
maxSize={1024}
/>,
);
fireEvent.change(fileInputEl(), {
target: {
files: [
createFile('photo.png', 100),
createFile('large.pdf', 4096),
createFile('small.pdf', 100),
],
},
});
await waitFor(() => {
const status = document.querySelector('.astryx-field-status');
expect(status).toHaveTextContent(
'"photo.png" is not an accepted file type',
);
expect(status).toHaveTextContent('"large.pdf" exceeds 1.0 KB limit');
});
// The valid file is still accepted.
expect(onChange).toHaveBeenCalledWith([
expect.objectContaining({name: 'small.pdf'}),
]);
});
it('separates the rejected files in a locale whose unit list would run them together', async () => {
render(
<InternationalizationProvider
locale="zh-CN"
overrides={{
'zh-CN': {
'@astryx.fileInput.errorInvalidType': '“{fileName}”类型不受支持',
'@astryx.fileInput.errorMaxSize': '“{fileName}”超过 {maxSize}',
},
}}>
<FileInput
label="报告"
value={null}
onChange={() => {}}
isMultiple
accept=".pdf"
maxSize={1024}
/>
</InternationalizationProvider>,
);
fireEvent.change(fileInputEl(), {
target: {
files: [createFile('photo.png', 100), createFile('large.pdf', 4096)],
},
});
await waitFor(() => {
const status = document.querySelector('.astryx-field-status');
// The two messages are separated (、), not run together.
expect(status?.textContent).toMatch(
/“photo\.png”类型不受支持、“large\.pdf”超过 /,
);
});
});
it('announces a validation error exactly once across live regions', async () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
accept=".pdf"
/>,
);
fireEvent.change(fileInputEl(), {
target: {files: [createFile('note.txt', 100)]},
});
const errorText = '"note.txt" is not an accepted file type';
// The error lands in the assertive announce region (via the FieldStatus
// the derived error status mounts)…
await waitFor(() => {
expect(
document.querySelector('[data-astryx-live-region="assertive"]'),
).toHaveTextContent(errorText);
});
// …and in exactly one live region overall. FileInput's own role="status"
// region used to duplicate the FieldStatus announcement, so the same
// error was read twice (assertively, then politely).
const liveRegions = Array.from(
document.querySelectorAll(
'[role="status"], [role="alert"], [aria-live]',
),
);
const regionsWithError = liveRegions.filter(el =>
(el.textContent ?? '').includes(errorText),
);
expect(regionsWithError).toHaveLength(1);
});
});
describe('validation', () => {
it.each([
{maxSize: 0, expected: '0 B'},
{maxSize: 1023, expected: '1023 B'},
{maxSize: 1024, expected: '1.0 KB'},
{maxSize: 1048575, expected: '1024.0 KB'},
{maxSize: 1048576, expected: '1.0 MB'},
{maxSize: 1572864, expected: '1.5 MB'},
])(
'preserves the English size boundary at $maxSize bytes',
({maxSize, expected}) => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
maxSize={maxSize}
/>,
);
fireEvent.change(fileInputEl(), {
target: {files: [createFile('big.txt', maxSize + 1)]},
});
expect(
screen.getByText(`"big.txt" exceeds ${expected} limit`),
).toBeInTheDocument();
},
);
it.each([
{
maxSize: 512,
sizeKey: 'bytes',
message: '{size, number} octets',
expected: '512 octets',
},
{
maxSize: 1536,
sizeKey: 'kilobytes',
message: '{size, number, ::.0} ko',
expected: '1,5 ko',
},
{
maxSize: 1572864,
sizeKey: 'megabytes',
message: '{size, number, ::.0} Mo',
expected: '1,5 Mo',
},
])(
'localizes the $sizeKey size in validation feedback',
({maxSize, sizeKey, message, expected}) => {
const handleChange = vi.fn();
render(
<InternationalizationProvider
locale="fr"
overrides={{
fr: {
'@astryx.fileInput.errorMaxSize':
'{maxSize} maximum pour {fileName}',
[`@astryx.fileInput.fileSize.${sizeKey}`]: message,
},
}}>
<FileInput
label="Upload"
value={null}
onChange={handleChange}
maxSize={maxSize}
/>
</InternationalizationProvider>,
);
fireEvent.change(fileInputEl(), {
target: {files: [createFile('big.txt', maxSize + 1)]},
});
expect(
screen.getByText(`${expected} maximum pour big.txt`),
).toBeInTheDocument();
expect(handleChange).toHaveBeenCalledWith(null);
},
);
it('rejects files exceeding maxSize', () => {
const handleChange = vi.fn();
render(
<FileInput
label="Upload"
value={null}
onChange={handleChange}
maxSize={1024}
/>,
);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const largeFile = createFile('big.txt', 2048);
fireEvent.change(input, {target: {files: [largeFile]}});
expect(handleChange).toHaveBeenCalledWith(null);
});
it('accepts files within maxSize', () => {
const handleChange = vi.fn();
render(
<FileInput
label="Upload"
value={null}
onChange={handleChange}
maxSize={1024}
/>,
);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const file = createFile('small.txt', 512);
fireEvent.change(input, {target: {files: [file]}});
expect(handleChange).toHaveBeenCalledWith(file);
});
it('limits files to maxFiles', () => {
const handleChange = vi.fn();
render(
<FileInput
label="Upload"
value={null}
onChange={handleChange}
isMultiple
maxFiles={2}
/>,
);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const files = [
createFile('a.txt', 100),
createFile('b.txt', 100),
createFile('c.txt', 100),
];
fireEvent.change(input, {target: {files}});
expect(handleChange).toHaveBeenCalledWith([
expect.objectContaining({name: 'a.txt'}),
expect.objectContaining({name: 'b.txt'}),
]);
});
it('rejects files with non-matching accept types', () => {
const handleChange = vi.fn();
render(
<FileInput
label="Upload"
value={null}
onChange={handleChange}
accept=".pdf"
/>,
);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const file = createFile('image.png', 100, 'image/png');
fireEvent.change(input, {target: {files: [file]}});
expect(handleChange).toHaveBeenCalledWith(null);
});
it('accepts files matching wildcard accept types', () => {
const handleChange = vi.fn();
render(
<FileInput
label="Upload"
value={null}
onChange={handleChange}
accept="image/*"
/>,
);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const file = createFile('photo.jpg', 100, 'image/jpeg');
fireEvent.change(input, {target: {files: [file]}});
expect(handleChange).toHaveBeenCalledWith(file);
});
});
describe('clear button', () => {
it('shows clear button when files are selected', () => {
const file = createFile('test.txt', 100);
render(<FileInput label="Upload" value={file} onChange={() => {}} />);
expect(
screen.getByRole('button', {name: 'Clear Upload'}),
).toBeInTheDocument();
});
it('does not show clear button when no files selected', () => {
render(<FileInput label="Upload" value={null} onChange={() => {}} />);
expect(
screen.queryByRole('button', {name: 'Clear Upload'}),
).not.toBeInTheDocument();
});
it('does not show clear button when disabled', () => {
const file = createFile('test.txt', 100);
render(
<FileInput
label="Upload"
value={file}
onChange={() => {}}
isDisabled
/>,
);
expect(
screen.queryByRole('button', {name: 'Clear Upload'}),
).not.toBeInTheDocument();
});
it('calls onChange with null when clear is clicked', async () => {
const user = userEvent.setup();
const handleChange = vi.fn();
const file = createFile('test.txt', 100);
render(<FileInput label="Upload" value={file} onChange={handleChange} />);
await user.click(screen.getByRole('button', {name: 'Clear Upload'}));
expect(handleChange).toHaveBeenCalledWith(null);
});
it('returns focus to the trigger, not the aria-hidden native input, after a keyboard clear', () => {
const file = createFile('test.txt', 100);
render(<FileInput label="Upload" value={file} onChange={() => {}} />);
fireEvent.click(screen.getByRole('button', {name: 'Clear Upload'}), {
detail: 0,
});
expect(screen.getByRole('button', {name: /^Upload/})).toHaveFocus();
});
it('returns focus to the trigger, not the aria-hidden native input, after a pointer clear', async () => {
const raf = vi
.spyOn(window, 'requestAnimationFrame')
.mockImplementation(cb => {
cb(0);
return 0;
});
const user = userEvent.setup();
const file = createFile('test.txt', 100);
render(<FileInput label="Upload" value={file} onChange={() => {}} />);
await user.click(screen.getByRole('button', {name: 'Clear Upload'}));
expect(screen.getByRole('button', {name: /^Upload/})).toHaveFocus();
raf.mockRestore();
});
it('calls onChange and changeAction with null when clear is clicked', async () => {
const user = userEvent.setup();
const order: string[] = [];
const handleChange = vi.fn(() => {
order.push('onChange');
});
const changeAction = vi.fn(async () => {
order.push('changeAction');
});
const file = createFile('test.txt', 100);
render(
<FileInput
label="Upload"
value={file}
onChange={handleChange}
changeAction={changeAction}
/>,
);
await user.click(screen.getByRole('button', {name: 'Clear Upload'}));
expect(handleChange).toHaveBeenCalledWith(null);
expect(changeAction).toHaveBeenCalledWith(null);
expect(order).toEqual(['onChange', 'changeAction']);
});
it('presents optimistic cleared state and busy indicator while clear changeAction is pending', async () => {
const user = userEvent.setup();
let resolveAction: () => void = () => {};
const changeAction = vi.fn(
async () =>
new Promise<void>(resolve => {
resolveAction = resolve;
}),
);
const file = createFile('test.txt', 100);
render(
<FileInput
label="Upload"
value={file}
onChange={() => {}}
changeAction={changeAction}
/>,
);
const trigger = screen.getByRole('button', {
name: 'Upload, test.txt',
});
expect(trigger).not.toHaveAttribute('aria-busy');
expect(
screen.getByRole('button', {name: 'Clear Upload'}),
).toBeInTheDocument();
await user.click(screen.getByRole('button', {name: 'Clear Upload'}));
expect(trigger).toHaveAttribute('aria-busy', 'true');
expect(
screen.queryByRole('button', {name: 'Clear Upload'}),
).not.toBeInTheDocument();
await act(async () => {
resolveAction();
});
});
it('does not show clear button during loading', () => {
const file = createFile('test.txt', 100);
render(
<FileInput label="Upload" value={file} onChange={() => {}} isLoading />,
);
expect(
screen.queryByRole('button', {name: 'Clear Upload'}),
).not.toBeInTheDocument();
});
});
describe('changeAction and optimistic updates', () => {
it('calls changeAction with selected file in a transition', async () => {
const order: string[] = [];
const handleChange = vi.fn(() => {
order.push('onChange');
});
const changeAction = vi.fn(async () => {
order.push('changeAction');
});
render(
<FileInput
label="Upload"
value={null}
onChange={handleChange}
changeAction={changeAction}
/>,
);
const input = fileInputEl();
const file = createFile('resume.pdf', 200, 'application/pdf');
await act(async () => {
fireEvent.change(input, {target: {files: [file]}});
});
expect(handleChange).toHaveBeenCalledWith(file);
expect(changeAction).toHaveBeenCalledWith(file);
expect(order).toEqual(['onChange', 'changeAction']);
});
it('presents optimistic file name and aria-busy while changeAction is pending', async () => {
let resolveAction: () => void = () => {};
const changeAction = vi.fn(
async () =>
new Promise<void>(resolve => {
resolveAction = resolve;
}),
);
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
changeAction={changeAction}
/>,
);
const trigger = screen.getByRole('button', {name: 'Upload'});
expect(trigger).not.toHaveAttribute('aria-busy');
const input = fileInputEl();
const file = createFile('report.pdf', 300, 'application/pdf');
fireEvent.change(input, {target: {files: [file]}});
expect(trigger).toHaveAttribute('aria-busy', 'true');
expect(screen.getByText('report.pdf')).toBeInTheDocument();
await act(async () => {
resolveAction();
});
});
});
describe('busy interaction', () => {
it('keeps a loading trigger focusable without opening the picker on click, Enter or Space', async () => {
const user = userEvent.setup();
render(
<FileInput label="Upload" value={null} onChange={() => {}} isLoading />,
);
const trigger = screen.getByRole('button', {name: 'Upload'});
const click = vi.spyOn(fileInputEl(), 'click');
await user.click(screen.getByText('Choose file'));
await user.tab();
expect(trigger).toHaveFocus();
await user.keyboard('{Enter} ');
fireEvent.click(trigger);
expect(click).not.toHaveBeenCalled();
expect(trigger).toHaveFocus();
expect(trigger).toHaveAttribute('aria-busy', 'true');
expect(trigger).toHaveAttribute('aria-disabled', 'true');
click.mockRestore();
});
it('ignores dropped files while loading without starting another Action', async () => {
const onChange = vi.fn();
const changeAction = vi.fn(async () => {});
render(
<FileInput
label="Upload"
value={null}
onChange={onChange}
changeAction={changeAction}
mode="dropzone"
isLoading
/>,
);
const trigger = screen.getByRole('button', {name: 'Upload'});
const drop = createEvent.drop(trigger, {
dataTransfer: {files: [createFile('dropped.txt', 100)]},
});
await act(async () => fireEvent(trigger, drop));
expect(drop.defaultPrevented).toBe(true);
expect(onChange).not.toHaveBeenCalled();
expect(changeAction).not.toHaveBeenCalled();
});
it('cancels native input activation while loading and preserves the idle caller handler', () => {
const onClick = vi.fn();
const props = {label: 'Upload', value: null, onChange: vi.fn(), onClick};
const {rerender} = render(<FileInput {...props} isLoading />);
const input = fileInputEl();
expect(fireEvent.click(input)).toBe(false);
expect(onClick).not.toHaveBeenCalled();
rerender(<FileInput {...props} />);
expect(fireEvent.click(input)).toBe(true);
expect(onClick).toHaveBeenCalledTimes(1);
});
it('ignores a native picker result delivered after loading starts and accepts it once idle', () => {
const onChange = vi.fn();
const props = {label: 'Upload', value: null, onChange};
const {rerender} = render(<FileInput {...props} />);
const input = fileInputEl();
const file = createFile('report.txt', 100);
fireEvent.click(screen.getByRole('button', {name: 'Upload'}));
rerender(<FileInput {...props} isLoading />);
fireEvent.change(input, {target: {files: [file]}});
expect(onChange).not.toHaveBeenCalled();
rerender(<FileInput {...props} />);
fireEvent.change(input, {target: {files: [file]}});
expect(onChange).toHaveBeenCalledExactlyOnceWith(file);
});
it('discards drag feedback when loading starts and ignores new drags until idle', () => {
const props = {
label: 'Upload',
value: null,
onChange: vi.fn(),
mode: 'dropzone' as const,
};
const {rerender} = render(<FileInput {...props} isLoading />);
const trigger = screen.getByRole('button', {name: 'Upload'});
const enter = createEvent.dragEnter(trigger);
const over = createEvent.dragOver(trigger);
fireEvent(trigger, enter);
fireEvent(trigger, over);
expect(enter.defaultPrevented).toBe(true);
expect(over.defaultPrevented).toBe(true);
rerender(<FileInput {...props} />);
expect(screen.getByText('Choose file')).toBeInTheDocument();
expect(screen.queryByText('Drop files here')).not.toBeInTheDocument();
fireEvent.dragEnter(trigger);
expect(screen.getByText('Drop files here')).toBeInTheDocument();
rerender(<FileInput {...props} isLoading />);
rerender(<FileInput {...props} />);
expect(screen.getByText('Choose file')).toBeInTheDocument();
expect(screen.queryByText('Drop files here')).not.toBeInTheDocument();
fireEvent.dragOver(trigger);
expect(screen.getByText('Drop files here')).toBeInTheDocument();
});
it.each([
['busy', {isLoading: true}],
['disabled', {isDisabled: true}],
])(
'refuses the drag with the no-drop effect while %s, and still cancels it',
(_state, state) => {
render(
<FileInput
label="Upload"
value={null}
onChange={vi.fn()}
mode="dropzone"
{...state}
/>,
);
const trigger = screen.getByRole('button', {name: 'Upload'});
for (const type of ['dragEnter', 'dragOver'] as const) {
const dataTransfer = {dropEffect: 'copy', files: []};
const event = createEvent[type](trigger, {dataTransfer});
fireEvent(trigger, event);
expect(dataTransfer.dropEffect).toBe('none');
expect(event.defaultPrevented).toBe(true);
}
},
);
it('keeps the copy effect for an idle dropzone', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={vi.fn()}
mode="dropzone"
/>,
);
const trigger = screen.getByRole('button', {name: 'Upload'});
for (const type of ['dragEnter', 'dragOver'] as const) {
const dataTransfer = {dropEffect: 'copy', files: []};
fireEvent(trigger, createEvent[type](trigger, {dataTransfer}));
expect(dataTransfer.dropEffect).toBe('copy');
}
});
it('blocks a second pick while changeAction is pending and allows picking again after settlement', async () => {
let finish: () => void = () => {};
const pending = new Promise<void>(resolve => {
finish = resolve;
});
const onChange = vi.fn();
const changeAction = vi.fn(async () => pending);
render(
<FileInput
label="Upload"
value={null}
onChange={onChange}
changeAction={changeAction}
mode="dropzone"
/>,
);
const trigger = screen.getByRole('button', {name: 'Upload'});
const input = fileInputEl();
const click = vi.spyOn(input, 'click');
trigger.focus();
fireEvent.change(input, {
target: {files: [createFile('first.txt', 100)]},
});
try {
expect(trigger).toHaveAttribute('aria-busy', 'true');
fireEvent.click(trigger);
fireEvent.keyDown(trigger, {key: 'Enter'});
fireEvent.keyDown(trigger, {key: ' '});
fireEvent.drop(trigger, {
dataTransfer: {files: [createFile('second.txt', 100)]},
});
expect(click).not.toHaveBeenCalled();
expect(onChange).toHaveBeenCalledTimes(1);
expect(changeAction).toHaveBeenCalledTimes(1);
expect(trigger).toHaveFocus();
expect(trigger).toHaveAttribute('aria-disabled', 'true');
} finally {
await act(async () => finish());
click.mockRestore();
}
expect(trigger).not.toHaveAttribute('aria-busy');
expect(trigger).not.toHaveAttribute('aria-disabled', 'true');
fireEvent.change(input, {
target: {files: [createFile('after.txt', 100)]},
});
await act(async () => {});
expect(onChange).toHaveBeenCalledTimes(2);
expect(changeAction).toHaveBeenCalledTimes(2);
});
});
describe('drag and drop', () => {
it('calls onChange when files are dropped in dropzone mode', () => {
const handleChange = vi.fn();
render(
<FileInput
label="Upload"
value={null}
onChange={handleChange}
mode="dropzone"
/>,
);
const dropzone = screen.getByRole('button', {name: 'Upload'});
const file = createFile('dropped.txt', 100);
fireEvent.drop(dropzone, {
dataTransfer: {files: [file]},
});
expect(handleChange).toHaveBeenCalledWith(file);
});
it('does not handle drop in input mode', () => {
const handleChange = vi.fn();
render(<FileInput label="Upload" value={null} onChange={handleChange} />);
const dropzone = screen.getByRole('button', {name: 'Upload'});
const file = createFile('dropped.txt', 100);
fireEvent.drop(dropzone, {
dataTransfer: {files: [file]},
});
expect(handleChange).not.toHaveBeenCalled();
});
it('does not handle drop when disabled', () => {
const handleChange = vi.fn();
render(
<FileInput
label="Upload"
value={null}
onChange={handleChange}
mode="dropzone"
isDisabled
/>,
);
const dropzone = screen.getByRole('button', {name: 'Upload'});
const file = createFile('dropped.txt', 100);
fireEvent.drop(dropzone, {
dataTransfer: {files: [file]},
});
expect(handleChange).not.toHaveBeenCalled();
});
});
describe('keyboard interaction', () => {
it('opens file picker on Enter key', () => {
render(<FileInput label="Upload" value={null} onChange={() => {}} />);
const dropzone = screen.getByRole('button', {name: 'Upload'});
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const clickSpy = vi.spyOn(input, 'click');
fireEvent.keyDown(dropzone, {key: 'Enter'});
expect(clickSpy).toHaveBeenCalled();
clickSpy.mockRestore();
});
it('opens file picker on Space key', () => {
render(<FileInput label="Upload" value={null} onChange={() => {}} />);
const dropzone = screen.getByRole('button', {name: 'Upload'});
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const clickSpy = vi.spyOn(input, 'click');
fireEvent.keyDown(dropzone, {key: ' '});
expect(clickSpy).toHaveBeenCalled();
clickSpy.mockRestore();
});
});
describe('dropzone mode', () => {
it('renders in dropzone mode', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
mode="dropzone"
/>,
);
expect(screen.getByText('Choose file')).toBeInTheDocument();
});
it('keeps the drag-over state while dragging over the dropzone children', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
mode="dropzone"
/>,
);
const dropzone = screen.getByRole('button', {name: 'Upload'});
fireEvent.dragEnter(dropzone);
expect(screen.getByText('Drop files here')).toBeInTheDocument();
// Moving from the container onto one of its own children fires a
// dragleave on the container with the child as relatedTarget — the
// highlight must not flicker off while still inside the dropzone.
// (jsdom's DragEvent init drops relatedTarget, so set it directly.)
const child = screen.getByText('Drop files here');
const leaveToChild = createEvent.dragLeave(dropzone);
Object.defineProperty(leaveToChild, 'relatedTarget', {value: child});
fireEvent(dropzone, leaveToChild);
expect(screen.getByText('Drop files here')).toBeInTheDocument();
// Actually leaving the dropzone ends the drag-over state.
const leaveToOutside = createEvent.dragLeave(dropzone);
Object.defineProperty(leaveToOutside, 'relatedTarget', {
value: document.body,
});
fireEvent(dropzone, leaveToOutside);
expect(screen.queryByText('Drop files here')).not.toBeInTheDocument();
expect(screen.getByText('Choose file')).toBeInTheDocument();
});
it('displays file name in dropzone mode', () => {
const file = createFile('doc.pdf', 100, 'application/pdf');
render(
<FileInput
label="Upload"
value={file}
onChange={() => {}}
mode="dropzone"
/>,
);
expect(screen.getByText('doc.pdf')).toBeInTheDocument();
});
});
describe('trigger accessible name', () => {
it('includes the selected file name in the trigger name', () => {
const file = createFile('report.pdf', 1024, 'application/pdf');
render(<FileInput label="Document" value={file} onChange={() => {}} />);
expect(
screen.getByRole('button', {name: 'Document, report.pdf'}),
).toBeInTheDocument();
});
it('includes all selected file names when multiple files are selected', () => {
const files = [createFile('a.txt', 100), createFile('b.txt', 200)];
render(
<FileInput
label="Files"
value={files}
onChange={() => {}}
isMultiple
/>,
);
expect(
screen.getByRole('button', {name: 'Files, a.txt, b.txt'}),
).toBeInTheDocument();
});
it('uses exactly the label when no files are selected', () => {
render(<FileInput label="Document" value={null} onChange={() => {}} />);
expect(screen.getByRole('button', {name: 'Document'})).toHaveAttribute(
'aria-label',
'Document',
);
});
it('includes the selected file name in dropzone mode', () => {
const file = createFile('doc.pdf', 100, 'application/pdf');
render(
<FileInput
label="Upload"
value={file}
onChange={() => {}}
mode="dropzone"
/>,
);
expect(
screen.getByRole('button', {name: 'Upload, doc.pdf'}),
).toBeInTheDocument();
});
});
describe('data-testid', () => {
it('passes data-testid to native input', () => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
data-testid="file-upload"
/>,
);
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
expect(input).toHaveAttribute('data-testid', 'file-upload');
});
});
describe('disabledMessage', () => {
it('shows the reason tooltip on hover when disabled with a reason', async () => {
render(
<FileInput
label="Resume"
value={null}
onChange={() => {}}
isDisabled
disabledMessage="You need the Editor role"
/>,
);
const tooltip = screen.getByRole('tooltip', h);
expect(tooltip).toHaveTextContent('You need the Editor role');
// The trigger button is visually hidden, so the disabled-reason tooltip
// anchors its hover listeners to the visible container surface.
const surface = document.querySelector(
'.astryx-file-input',
) as HTMLElement;
fireEvent.mouseEnter(surface);
await waitFor(() => {
expect(tooltip).toHaveAttribute('popover-open');
});
fireEvent.mouseLeave(surface);
await waitFor(() => {
expect(tooltip).not.toHaveAttribute('popover-open');
});
});
it('shows the reason tooltip on keyboard focus', async () => {
const user = userEvent.setup();
render(
<FileInput
label="Resume"
value={null}
onChange={() => {}}
isDisabled
disabledMessage="You need the Editor role"
/>,
);
const tooltip = screen.getByRole('tooltip', h);
await user.tab();
expect(screen.getByRole('button')).toHaveFocus();
await waitFor(() => {
expect(tooltip).toHaveAttribute('popover-open');
});
});
it('does not render a tooltip when not disabled', () => {
render(
<FileInput
label="Resume"
value={null}
onChange={() => {}}
disabledMessage="You need the Editor role"
/>,
);
expect(screen.queryByRole('tooltip', h)).not.toBeInTheDocument();
});
it('does not render a tooltip when disabled without a reason', () => {
render(
<FileInput
label="Resume"
value={null}
onChange={() => {}}
isDisabled
/>,
);
expect(screen.queryByRole('tooltip', h)).not.toBeInTheDocument();
});
it('keeps the trigger focusable via aria-disabled when a reason is provided', () => {
render(
<FileInput
label="Resume"
value={null}
onChange={() => {}}
isDisabled
disabledMessage="You need the Editor role"
/>,
);
const trigger = screen.getByRole('button');
expect(trigger).toHaveAttribute('aria-disabled', 'true');
expect(trigger).toHaveAttribute('tabindex', '0');
});
it('links the reason tooltip from the trigger via aria-describedby', () => {
render(
<FileInput
label="Resume"
value={null}
onChange={() => {}}
isDisabled
disabledMessage="You need the Editor role"
/>,
);
const trigger = screen.getByRole('button');
const tooltip = screen.getByRole('tooltip', h);
expect(trigger.getAttribute('aria-describedby')).toContain(tooltip.id);
});
it('blocks opening the file picker while focusable-disabled', async () => {
// The trigger is a visually-hidden button (pointer-events: none) — real
// pointer clicks land on the container surface, so bypass the pointer
// check to exercise the disabled guard directly.
const user = userEvent.setup({pointerEventsCheck: 0});
render(
<FileInput
label="Resume"
value={null}
onChange={() => {}}
isDisabled
disabledMessage="You need the Editor role"
/>,
);
const trigger = screen.getByRole('button');
const input = document.querySelector(
'input[type="file"]',
) as HTMLInputElement;
const clickSpy = vi.spyOn(input, 'click');
await user.click(trigger);
trigger.focus();
await user.keyboard('{Enter}');
await user.keyboard(' ');
expect(clickSpy).not.toHaveBeenCalled();
});
it('keeps the trigger focusable when disabled without a reason', () => {
render(
<FileInput
label="Resume"
value={null}
onChange={() => {}}
isDisabled
/>,
);
const trigger = screen.getByRole('button');
expect(trigger).toHaveAttribute('tabindex', '0');
expect(trigger).toHaveAttribute('aria-disabled', 'true');
});
});
});
describe('FileInput statusVariant forwarding', () => {
it('defaults to attached (status renders with data-variant="attached")', () => {
const {container} = render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
status={{type: 'error', message: 'Something went wrong'}}
/>,
);
expect(container.querySelector('.astryx-field-status')).toHaveAttribute(
'data-variant',
'attached',
);
});
it('forwards statusVariant="detached" to the underlying Field status', () => {
const {container} = render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
status={{type: 'error', message: 'Something went wrong'}}
statusVariant="detached"
/>,
);
expect(container.querySelector('.astryx-field-status')).toHaveAttribute(
'data-variant',
'detached',
);
});
// family:input-fields FR8: every input offers the tooltip placement. It has
// no message box, so the status button is the only place the message lives.
function expectReachableTooltipStatus(message: string) {
expect(
screen.getByRole('button', {name: 'Error details'}),
).toBeInTheDocument();
expect(screen.getByRole('tooltip', h)).toHaveTextContent(message);
const trigger = screen.getByRole('button', {name: 'Upload'});
const describedBy = (trigger.getAttribute('aria-describedby') ?? '')
.split(' ')
.filter(Boolean);
expect(describedBy.length).toBeGreaterThan(0);
for (const id of describedBy) {
expect(document.getElementById(id)).not.toBeNull();
}
}
it.each(['input', 'dropzone'] as const)(
'keeps a statusVariant="tooltip" message reachable in %s mode',
mode => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
mode={mode}
status={{type: 'error', message: 'File must be under 10MB'}}
statusVariant="tooltip"
/>,
);
expectReachableTooltipStatus('File must be under 10MB');
},
);
it('does not open the file picker from the dropzone status button', async () => {
const user = userEvent.setup();
const click = vi.spyOn(HTMLInputElement.prototype, 'click');
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
mode="dropzone"
status={{type: 'error', message: 'File must be under 10MB'}}
statusVariant="tooltip"
/>,
);
await user.click(screen.getByRole('button', {name: 'Error details'}));
expect(click).not.toHaveBeenCalled();
click.mockRestore();
});
it.each(['input', 'dropzone'] as const)(
'keeps a statusVariant="tooltip" message reachable while loading in %s mode',
mode => {
render(
<FileInput
label="Upload"
value={null}
onChange={() => {}}
mode={mode}
isLoading
status={{type: 'error', message: 'File must be under 10MB'}}
statusVariant="tooltip"
/>,
);
expectReachableTooltipStatus('File must be under 10MB');
},
);
});
// component:Tooltip FR11: the status tooltip renders inside the clickable
// surface, so a click on its text must stay in the tooltip.
describe('FileInput status tooltip press', () => {
it.each(['input', 'dropzone'] as const)(
'a click on the tooltip text does not open the picker in %s mode',
mode => {
render(
<FileInput
label="Upload"
mode={mode}
value={null}
onChange={() => {}}
status={{type: 'error', message: 'File must be under 10MB'}}
statusVariant="tooltip"
/>,
);
const openPicker = vi.spyOn(fileInputEl(), 'click');
fireEvent.click(
within(screen.getByRole('tooltip', h)).getByText(
'File must be under 10MB',
),
);
expect(openPicker).not.toHaveBeenCalled();
// Positive control: a click on the surface itself still opens it.
fireEvent.click(screen.getByRole('button', {name: 'Upload'}));
expect(openPicker).toHaveBeenCalledTimes(1);
},
);
});