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.
Example
> 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 ]
arrayBack
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 |
Load anywhere
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')).default
From 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.