Cast a value as an array

Wrap a single value in an array and return arrays unchanged.

JavaScript Version 1.0.0 · MIT · .md

cast-a-value-as-an-array.js
function castArray(value) { return Array.isArray(value) ? value : [value]; }

Input & expected output

Input

"[email protected]"

Expected output

[
  "[email protected]"
]

The edge case

Input

[]

Expected output

[]

Know the limits

  • Arrays are returned as they are, not copied.
  • Useful for a field that accepts one value or many, such as a list of recipients, before iterating over it.

The function above is the implementation used by the lab. The lab validates JSON types and caps size before execution; include equivalent validation when accepting untrusted input in your application.

Source & maintenance

Based on Cast a value as an array from the original 1loc collection by Nguyen Huu Phuoc. Copyright (c) 2020 phuoc-ng. MIT licensed.

Original implementation kept; explicit contract and edge case. Original MDX retained as inert source evidence.

Maintained by Oveyon. Source commit: 14b481cf60df. Read the license.

Local fixture scope · Node.js 22.23.2 · reviewed October 28, 2026. No external service is required.

Keep exploring

Type two or more characters. Try “duplicate”, “webhook” or “retry”.