readme.md

array-back

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 than Set) 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.