An open source design system that's fully customizable and agent ready
TypeScript
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
* @file MultiSelector.fr10.test.tsx
* @input Uses vitest, Testing Library, the shared FR10 suites, and MultiSelector
* @output Tests that MultiSelector's base props, container*, and control* reach
* their family:input-fields FR10 targets
* @position Tests; MultiSelector's FR10 conformance alongside MultiSelector.test.tsx
*/
import {beforeEach, describe, expect, it, vi} from 'vitest';
import {fireEvent, render, screen} from '@testing-library/react';
import {expectFieldInputProps} from '../Field/fieldInputFamily.testing';
import {describeFieldInputParts} from '../Field/fieldInputFamily.render-testing';
import {MultiSelector, type MultiSelectorProps} from './MultiSelector';
const NO_VALUE: string[] = [];
const OPTIONS = ['Apple', 'Banana'];
// jsdom has no Popover API; reflect open state the way the browser does.
beforeEach(() => {
HTMLElement.prototype.showPopover = vi.fn(function (this: HTMLElement) {
this.setAttribute('popover-open', '');
const event = new Event('toggle');
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');
Object.defineProperty(event, 'newState', {value: 'closed'});
this.dispatchEvent(event);
});
});
describe('MultiSelector props type (family:input-fields FR10)', () => {
it('accepts container* and control* and no root styling', () => {
expectFieldInputProps<MultiSelectorProps>();
});
});
describeFieldInputParts('MultiSelector', {
renderMember: props => (
<MultiSelector
label="Fruit"
options={OPTIONS}
value={NO_VALUE}
onChange={() => {}}
{...props}
/>
),
getControl: () => screen.getByRole('combobox'),
inGroup: true,
});
describe('MultiSelector FR10 targets', () => {
it('keeps a caller aria-describedby alongside the field description', () => {
render(
<MultiSelector
label="Fruit"
options={OPTIONS}
value={NO_VALUE}
onChange={() => {}}
description="Pick one"
aria-describedby="caller-help"
/>,
);
const ids = (
screen.getByRole('combobox').getAttribute('aria-describedby') ?? ''
).split(' ');
expect(ids).toContain('caller-help');
expect(
ids.map(id => document.getElementById(id)?.textContent ?? '').join(' '),
).toContain('Pick one');
});
it('puts control* on the bordered control box around the trigger, not on the trigger or the popup', () => {
render(
<MultiSelector
label="Fruit"
options={OPTIONS}
value={NO_VALUE}
onChange={() => {}}
controlClassName="fr10-control"
containerClassName="fr10-container"
/>,
);
const trigger = screen.getByRole('combobox');
const controlBox = document.querySelector('.fr10-control') as HTMLElement;
expect(controlBox).toHaveClass('astryx-multi-selector');
expect(controlBox).toContainElement(trigger);
expect(trigger).not.toHaveClass('fr10-control');
fireEvent.click(trigger);
expect(trigger).toHaveAttribute('aria-expanded', 'true');
expect(document.querySelectorAll('.fr10-control')).toHaveLength(1);
expect(document.querySelectorAll('.fr10-container')).toHaveLength(1);
expect(screen.getByRole('listbox', {hidden: true})).not.toHaveClass(
'fr10-control',
);
});
it('runs the built-in toggle before a consumer onClick, once per press', () => {
const states: (string | null)[] = [];
render(
<MultiSelector
label="Fruit"
options={OPTIONS}
value={NO_VALUE}
onChange={() => {}}
onClick={event => {
states.push(event.currentTarget.getAttribute('role') ?? 'button');
// Neither cancelling nor stopping the press undoes the built-in
// toggle, which already ran on the trigger button.
event.preventDefault();
event.stopPropagation();
}}
/>,
);
const trigger = screen.getByRole('combobox');
fireEvent.click(trigger);
expect(states).toHaveLength(1);
expect(trigger).toHaveAttribute('aria-expanded', 'true');
});
it('opens from a press on the control box outside the trigger button', () => {
const {container} = render(
<MultiSelector
label="Fruit"
options={OPTIONS}
value={NO_VALUE}
onChange={() => {}}
controlClassName="fr10-control"
/>,
);
const controlBox = container.querySelector('.fr10-control') as HTMLElement;
fireEvent.click(controlBox);
expect(screen.getByRole('combobox')).toHaveAttribute(
'aria-expanded',
'true',
);
});
it('keeps the built-in keyboard model and composes a consumer onKeyDown after it', () => {
const keyTargets: EventTarget[] = [];
render(
<MultiSelector
label="Fruit"
options={OPTIONS}
value={NO_VALUE}
onChange={() => {}}
onKeyDown={event => keyTargets.push(event.currentTarget)}
/>,
);
const trigger = screen.getByRole('combobox');
fireEvent.keyDown(trigger, {key: 'Tab'});
// The consumer handler lands on the trigger itself.
expect(keyTargets).toEqual([trigger]);
fireEvent.keyDown(trigger, {key: 'ArrowDown'});
expect(trigger).toHaveAttribute('aria-expanded', 'true');
});
});
describe('MultiSelector FR10 renderTrigger', () => {
it('forwards base props and the ref to the caller-rendered control', () => {
const ref = {current: null as HTMLElement | null};
const onClick = vi.fn();
render(
<MultiSelector
label="Fruit"
options={OPTIONS}
value={NO_VALUE}
onChange={() => {}}
ref={ref}
data-testid="opener"
aria-details="details-id"
onClick={onClick}
renderTrigger={props => (
<button type="button" {...props}>
Open
</button>
)}
/>,
);
const opener = screen.getByRole('button', {name: 'Open'});
expect(opener).toHaveAttribute('data-testid', 'opener');
expect(opener).toHaveAttribute('aria-details', 'details-id');
expect(ref.current).toBe(opener);
fireEvent.click(opener);
expect(onClick).toHaveBeenCalledTimes(1);
expect(opener).toHaveAttribute('aria-expanded', 'true');
});
it('warns that container* and control* have no effect', () => {
const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
const {container} = render(
<MultiSelector
label="Fruit"
options={OPTIONS}
value={NO_VALUE}
onChange={() => {}}
controlClassName="fr10-control"
renderTrigger={props => (
<button type="button" {...props}>
Open
</button>
)}
/>,
);
expect(container.querySelector('.fr10-control')).toBeNull();
expect(
warn.mock.calls.some(call =>
String(call[0]).startsWith(
'MultiSelector: `container*` and `control*`',
),
),
).toBe(true);
warn.mockRestore();
});
});