JS: Array-Like Object to Array

By Xah Lee. Date: . Last updated: .

How to convert array-like object to array?

Like this:

Array.from ( array_like_obj )

[see JS: Array.from]

Before ES2015

Here's how to convert array-like object to array using pre-ES2015 code.


// create a array-like object
const aa = {0:"a", 1:"b",2:"c", length:3};

// convert to array
const bb = Array.prototype.slice.call(aa);

console.log (
    Array.isArray(aa) // false

console.log (
    Array.isArray(bb) // true

console.log (aa); // { '0': 'a', '1': 'b', '2': 'c', length: 3 }
console.log (bb); // [ 'a', 'b', 'c' ]

How does this work?

The array method myArray.slice(…) with no argument will just make a shallow copy (and returns a array). We want to use this method on our array-like object alo.

[see JS: Array.prototype.slice]

By spec, the array method obj.slice() works by setting the function's keyword this to obj, then goes thru the object's numerical index or properties. So, that means it will also work with array-like objects. [see JS: Array-Like Object] [see JS: “this” Binding]

The problem is, alo isn't a array, so it doesn't inherit method “slice” from array object. What to do?

Array methods are properties of Array.prototype. So, “slice” can be accessed by calling Array.prototype.slice(…).

The problem is, slice(…) doesn't take a object as argument. Its only args are start/end indexes, for example: a_array.slice(start, end). How can we call “slice” by Array.prototype.slice() yet passing it alo?

This can be solved in general using the “call” method from “Function.prototype”. Like this function_name.call(alo, args).

So, we can do Array.prototype.slice.call(alo). [see JS: Function Call, Apply, Bind]

Why can we use call from Array.prototype.slice but call is a method of Function.prototype? Because Array.prototype.slice is a function, so its parent is Function.prototype, thus inherits the “call” method. This is why we can write Array.prototype.slice.call(…).

Here's a fuller explanation with code.

// the object 「Array」 is a standard object, and is a function object
console.log (
    typeof Array === "function"
); // true

// Array has a property key "prototype"
// every function has a property key "prototype", by spec.
console.log (
); // true

// the value of Array.prototype, is a object, and the only way to express it is just Array.prototype

// This object Array.prototype, is the parent of array data type object, by spec.
console.log (
    Object.getPrototypeOf([]) === Array.prototype
); // true

// This object Array.prototype has a property key "slice"
console.log (
); // true

// its value is a function
console.log (
    typeof Array.prototype.slice === "function"
); // true

// the parent of Array.prototype.slice is Function.prototype
console.log (
    Object.getPrototypeOf(Array.prototype.slice) === Function.prototype
); // true

// Function.prototype has a property key "call"
console.log (
    Function.prototype.hasOwnProperty("call") &&
    (Object.getOwnPropertyNames(Function.prototype).indexOf("call") >= 0)
); // true

// so when eval Array.prototype.slice.call, it's actually calling the value of the property key "call" of the object Function.prototype. Because, the property is in the prototype chain.

// what the 「‹f›.call(‹obj›)」 do is to call ‹f› with ‹f›'s 「this」 value set to 「obj」

To really understand it, read the following in order.

  1. JS: Prototype and Inheritance
  2. JS: “this” Binding
  3. JS: Function Call, Apply, Bind

Should You Convert a Array-Like Object to Array?

You almost NEVER need to convert a array-like object to true array.

You can use array methods directly, for example:

Array.prototype.forEach.call(array_like_obj, f)

[see JS: Function Call, Apply, Bind]

// using map directly on array-like object

// create a array-like object
const alo = {0:"a", 1:"b", 2:"c", length:3};

// the function you want to apply to array-like object's elements
function append_z_to_string (x) {return x + "z"; }

// using map on a array-like object
const myResult = Array.prototype.map.call( alo, append_z_to_string);

// result is a array
console.log (
    Array.isArray(myResult) // true

console.log (myResult); // [ 'az', 'bz', 'cz' ]

Convert Object to Array

[see JS: List Properties]

JS Array

  1. Understand JS Array
  2. Create Array
  3. Sparse Array
  4. Array-Like Object
  5. Array How-To

Like it? Help me by telling your friends. Or, Put $5 at patreon.

Or, Buy JavaScript in Depth

If you have a question, put $5 at patreon and message me.

Web Dev Tutorials