arc-array 

An array convenience subclass for javascript.

Install

``
$ npm install arc-array --save
`




Features

* callback based join
* native convenience binding (if desired)
* extends native array so should be compatible

API

$3

Accept an array, and if it is already an ArcArray return the same object, otherwise create a new ArcArray utilizing the passed in array

$3

Create a new ArcArray object. Requires new

$3

Shuffles an array in place.

$3

Returns a random element from the array

$3

Iterates over an array like a map, but treating each callable as async, awaits for all to resolve like a Promise.all

`js

const someArray = ArcArray.wrap([1,2,3]);
const someResolvedResponse = await someArray.pMap(async (val) => {
const response = await someRemoteCall(val);
return response;
})
`

$3

Create a string based on the returned values from a callback on each index of an array.

callback is a function that receives each value of the array, and is expected to return a value that will be used to create the joined string.

`js
//Example of joinCallback
const items = new ArcArray('item1','item2','item3');
const string = items.joinCallback(function(_val){
return '

'+_val+'

'
},'');

//String returned is:

item1

item2

item3

`

Testing

`
npm test
``