πŸ”₯ NEW Code Tidbit Every Week πŸ”₯

# Better Array check with Array.isArray

In JavaScript, arrays are not true arrays. They are actually objects. So you can't simply do a typeof check. Because it will return object 😱

But not a problem! Use Array.isArray() -- finally, there is an easier way to check if a value is an actual array πŸŽ‰

const books = ['πŸ“•', 'πŸ“™', 'πŸ“—'];

// Old way
Object.prototype.toString.call(books) === '[object Array]';

// βœ… Better
Array.isArray(books);

# Array is not a true array

Let's see what I mean by this, array is not a true array.

const array = [];

typeof array; // 'object'

☝️That's why you can't use your typical typeof. Because array is an object type πŸ˜•

# Array.isArray Demo

Alright, let's try this method on other values and see what we get πŸ‘©β€πŸ”¬

# These are all arrays, and will return true

// Empty Array
Array.isArray([]); // true

// Array
Array.isArray(['πŸ““']); // true

// Array Constructor
Array.isArray(new Array('πŸ““')); // true

# These are NOT arrays and will return false

// Object
Array.isArray({}); // false

// Object
Array.isArray({book: 'πŸ““'}); // false

// Number
Array.isArray(123); // false

// Boolean
Array.isArray(true); // false

// Boolean
Array.isArray(false); // false

// String
Array.isArray('hello'); // false

// Null
Array.isArray(null); // false

// Undefined
Array.isArray(undefined); // false

// NaN
Array.isArray(NaN); // false

# instanceof vs Array.isArray

Another popular choice you might is using instanceof

const books = ['πŸ“•', 'πŸ“™', 'πŸ“—'];

books instanceof Array; // true

# But...

The problem is it doesn't work with multiple context (e.g. frames or windows). Because each frame has different scopes with its own execution environment. Thus, it has a different global object and different constructors. So if you try to test an array against that frame's context, it will NOT return true, it will return incorrectly as false.

🀯 What are you talking about??? πŸ‘ˆ If this is floating in your mind. Don't worry, I was too. To understand this, you need to understand JavaScript's execution context. Here's a great video explaining it, An Introduction to Functions, Execution Context and the Call Stack. This is a bit more of an advanced topic, so if you're just a beginner, feel free to skip through it. And when you get a bit more comfortable with JavaScript, then definitely return to this topic. In the meantime, let me try to explain this "multiple context" in non-dev terms.

# Explanation in non-dev terms

You can think of frames like different planets. Every planet has its own system, with different gravity pull and composition. So instanceof only works on our planet, Earth. If you bring it to Mars, it won't work. However, with Array.isArray() it will work on any planet. It's universal. That's why you should use Array.isArray().

// Creating our new "planet" called mars
const mars = document.createElement('iframe');
document.body.appendChild(iframe);
xArray = window.frames[window.frames.length-1].Array;

// Let's make an array in our new "planet", mars
var marsArray = new xArray('πŸ‘©', 'πŸ‘¨');

// Using the instanceof tool to test the marsArray
marsArray instanceof Array;
//  false --> ❌ doesn't work

// Now, let's try using our universal tool
Array.isArray(marsArray)
// true --> βœ… great, it works!

# Community Input

https://jsfiddle.net/botol/ryu324gw

  • Cale Shapera:

  • @caleshapera: I like to use isArray along with array.length to error check whether I should process a variable.

if (!Array.isArray(array) || !array.length) {
  // array does not exist, is not an array, or is empty
  // β‡’ do not attempt to process array
} else {
  // β‡’ process array
}
  • Russel P: It's worth noting that Array.isArray(books) is the ES5 equivalent to books && typeof books === 'object' && books.constructor === Array

# Resources


Related Tidbits