> For the complete documentation index, see [llms.txt](https://www.strickland.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.strickland.io/composition/validating-array-elements/arrayelements.md).

# arrayElements

Strickland provides an `arrayElements` validator to apply a validator against all elements within an array. The `arrayElements` validator first validates that the value is an `Array` (using `Array.isArray`), and then it validates all elements of that array using the supplied validator.

### Parameters

The first parameter to the `arrayElements` validator factory is validator that will be used to validate each element of the value array. Validator props can also be supplied either as an object or as a function that accepts context and returns a validator props object.

```jsx
const allValuesRequired = arrayElements(
    required(),
    {message: 'Must have at least 5 characters'}
);

const result = validate(allValuesRequired, ['First', '', 'Third']);

const allValuesHaveMinLength = arrayElements(
    minLength((context) => ({minLength: context.minLength}))
    (context) => ({message: `All values must have at least ${context.minLength} characters`})
);
```

### Result Properties

* `arrayElements`: The array of validation results produced during validation

The `arrayElements` validator adds an `arrayElements` property to the validation result with the validation results of every array element that was validated. The validation result property is named `arrayElements` to match the name of the validator (this is a common pattern in Strickland).

```jsx
import validate, {every, required, minLength, maxLength} from 'strickland';

const allValuesHaveMinLength = arrayElements(
    minLength((context) => ({minLength: context.minLength}))
    (context) => ({message: `All values must have at least ${context.minLength} characters`})
);

const result = validate(
    allValuesHaveMinLength,
    ['1', '12', '123', '1234'],
    {minLength: 3}
);

/*
    result = {
        isValid: false,
        value: ['1', '12', '123', '1234'],
        message: 'All values must have at least 3 characters',
        arrayElements: [
            {
                isValid: false,
                value: '1',
                minLength: 3,
                length: 1
            },
            {
                isValid: false,
                value: '12',
                minLength: 3,
                length: 2
            },
            {
                isValid: true,
                value: '123',
                minLength: 3,
                length: 3
            },
            {
                isValid: true,
                value: '1234',
                minLength: 3,
                length: 4
            }
        ]
    }
 */
```