Takes any input and guarantees an array back.
- Converts array-like objects (e.g.
arguments
,Set
) to a real array. - Converts
undefined
to 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
> const arrayify = require('array-back')
> arrayify(undefined)
[]
> arrayify(null)
[ null ]
> arrayify(0)
[ 0 ]
> arrayify([ 1, 2 ])
[ 1, 2 ]
> arrayify(new Set([ 1, 2 ]))
[ 1, 2 ]
> function f(){ return arrayify(arguments); }
> f(1,2,3)
[ 1, 2, 3 ]
Kind: Exported function
Param | Type | Description |
---|---|---|
input | * |
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.
Node.js:
const arrayify = require('array-back')
Within Node.js with ECMAScript Module support enabled:
import arrayify from 'array-back'
Within an modern browser ECMAScript Module:
import arrayify from './node_modules/array-back/index.js'
© 2015-22 Lloyd Brookes <75pound@gmail.com>.
Isomorphic test suite by test-runner and web-runner. Documented by jsdoc-to-markdown.