Skip to content
Convert an array-like object into an Array.
JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
test
.gitignore
History.md
Makefile
Readme.md
component.json
index.js

Readme.md

to-array

Try convert an object into an Array

Installation

$ component install timoxley/to-array

Examples

// Array-likes
var divs = document.getElementsByTagName('div') // `NodeList` of `HTMLDivElement`
toArray(divs) // => Array of `HTMLDivElement`

(function() {
  toArray(arguments) // => [1, 2]
})(1, 2)

// Primitives
toArray('hello') // => ['hello']
toArray(12345) // => [12345]
toArray(/regex/) // => [/regex/]
toArray(null) // => [null]
toArray({}) // => [{}]
toArray(window) // => [window]
toArray(new Date) // => [Wed Nov 07 2012 04:40:26 GMT+1000 (EST)]

// Special case
toArray(undefined) // => []

API

toArray(collection): Array

Array-like structures like arguments, NodeList or HTMLCollection, will be converted into Arrays.

Date, String, Regex, null, Object, and Function will convert into an Array, with a single element being whatever was passed to toArray.

undefined will return an empty Array

Alternatives

wilmoore/to-array.js: slightly different semantics.

Contributors

  • 21 Tim Oxley 75.0%
  • 4 Jonny Strömberg 14.3%
  • 2 Forbes Lindesay 7.1%
  • 1 Dominic Barnes 3.6%

License

MIT

Something went wrong with that request. Please try again.