Takes any input and guarantees an array back.
- Converts array-like objects (e.g.
arguments,Set) to a real array. - Converts
undefinedto an empty array. - Converts any another other, singular value (including
null, objects and iterables other thanSet) into an array containing that value. - Ignores input which is already an array.
> arrayBack(undefined)
[]
> arrayBack(null)
[ null ]
> arrayBack(0)
[ 0 ]
> arrayBack([ 1, 2 ])
[ 1, 2 ]
> arrayBack(new Set([ 1, 2 ]))
[ 1, 2 ]
> function f(){ return arrayBack(arguments); }
> f(1,2,3)
[ 1, 2, 3 ]Takes any input and guarantees an array back.
- Type: Exported Synchronous Function
- Supported runtimes: Node.Js >= v12
- Module type: JavaScript
- Returns:
Array
| Param | Type | Description |
|---|---|---|
| input | any |
The input value to convert to an array |
This library is compatible with Node.js, the Web and any style of module loader. It can be loaded anywhere, natively without transpilation.
From a Node CommonJS module:
const arrayBack = (await import('array-back')).defaultFrom a Node.js JavaScript Module:
import arrayBack from 'array-back'Within an modern browser JavaScript Module:
import arrayBack from './node_modules/array-back/index.js'© 2015-26 Lloyd Brookes opensource@75lb.com.