Epic Web Conf late-bird tickets are available now, hurry!

Get your tickets here

Join the community and network with other great web devs.

Time's up. The sale is over

React Hooks: Array Destructuring Fundamentals

December 31st, 2018 — 8 min read

I made this all by myself... Well... Except for the react logo... And the font... and the theme.
I made this all by myself... Well... Except for the react logo... And the font... and the theme.

This is the first example on the https://reactjs.org/hooks documentation:

import {useState} from 'react'

function Example() {
  // Declare a new state variable, which we'll call "count"
  const [count, setCount] = useState(0)

  return (
    <div>
      <p>You clicked {count} times</p>
      <button onClick={() => setCount(count + 1)}>Click me</button>
    </div>
  )
}

That const [count, setCount] = useState(0); is the line we're going to be talking about today. The syntax here is called "array destructuring" and it was introduced into JavaScript in the infamous (more than famous) ES6 release.

I'm a firm believer that:

The better you understand an abstraction, the more effective you will be at using it. – me, literally right when I wrote this...

So when I see syntax that I'm unfamiliar with, I like to read about it and understand how it works with the rest of the language. The problem is that it can be difficult to "Google" syntax. Seriously... Try Googling the syntax itself as if you didn't know that it's called "destructuring." Pretty tough! So here's my trick. I go to astexplorer.net and paste in the code that I don't understand:

ASTExplorer.net with the code showing ArrayPattern

Cool! Babel calls that an "ArrayPattern." So let's go ahead and Google for that. We'll search for "site:https://developer.mozilla.org array pattern" (that way Google only returns results for articles on MDN which is a terrific resource on learning everything there is to know about JavaScript).

Sweet, the first result takes us to "Destructuring assignment" where we can learn all about this feature (I guess you can read that instead of continuing here if you want to 😅).

Often syntax like this is what we call "syntactic sugar" for other features. Here's what wikipedia says about syntactic sugar:

In computer science, syntactic sugar is syntax within a programming language that is designed to make things easier to read or to express. It makes the language "sweeter" for human use: things can be expressed more clearly, more concisely, or in an alternative style that some may prefer.

Ok, so basically it means that there are common patterns or ways to write code in a given language, so the language makes a syntax feature to make that pattern require less code or more expressive. With this in mind, when I'm learning new syntax, I like to "de-sugar" the syntax to see what it would look like if we didn't have that feature.

Luckily for us, we have Babel and TypeScript which can compile this newer syntax into something older browsers can support (and presumably to something we may be more familiar with). So my next step is to go to the online babel REPL and paste in the code. Here's what the result looks like:

'use strict'

var _slicedToArray = (function () {
  function sliceIterator(arr, i) {
    var _arr = []
    var _n = true
    var _d = false
    var _e = undefined
    try {
      for (
        var _i = arr[Symbol.iterator](), _s;
        !(_n = (_s = _i.next()).done);
        _n = true
      ) {
        _arr.push(_s.value)
        if (i && _arr.length === i) break
      }
    } catch (err) {
      _d = true
      _e = err
    } finally {
      try {
        if (!_n && _i['return']) _i['return']()
      } finally {
        if (_d) throw _e
      }
    }
    return _arr
  }
  return function (arr, i) {
    if (Array.isArray(arr)) {
      return arr
    } else if (Symbol.iterator in Object(arr)) {
      return sliceIterator(arr, i)
    } else {
      throw new TypeError(
        'Invalid attempt to destructure non-iterable instance',
      )
    }
  }
})()

// const [count, setCount] = useState(0);
var _useState = useState(0),
  _useState2 = _slicedToArray(_useState, 2),
  count = _useState2[0],
  setCount = _useState2[1]

😬 YIKES! Hmmm... Ok, so sometimes Babel uses utilities which both make it more compliant to the specification, but also can make the code a little harder to understand. Luckily, there's an option on the Babel Repl's "Env Preset" called "Loose" which will simplify this output considerably:

// const [count, setCount] = useState(0);
var _useState = useState(0),
  count = _useState[0],
  setCount = _useState[1]

😌 Phew, that's better. Ok, so what's going on here. Babel's taking our one line and rather than using the Array Pattern thing, it's assigning the return value of useState to a variable called _useState. Then it's treating _useState as an array and it assigns count to the first item in the array and setCount to the second one.

Let's play around with this a little bit to explore the syntax:

Can I call the values whatever I want?

// const [whateverIWant, reallyICanChooseWhatItIsCalled] = useState(0);
var _useState = useState(0),
  whateverIWant = _useState[0],
  reallyICanChooseWhatItIsCalled = _useState[1]

Can I add more elements?

// const [count, setCount, somethingElse] = useState(0);
var _useState = useState(0),
  count = _useState[0],
  setCount = _useState[1],
  somethingElse = _useState[2]

Can I pull out fewer?

// const [count] = useState(0);
var _useState = useState(0),
  count = _useState[0]

Can I skip one?

// const [, setCount] = useState(0);
var _useState = useState(0),
  setCount = _useState[1]

Can I skip more?

// const [,,, wow,, neat] = useState(0);
var _useState = useState(0),
  wow = _useState[3],
  neat = _useState[5]

I saw someone put a weird = sign in there, what does that do?

// const [count = 3, setCount] = useState(0);
var _useState = useState(0),
  _useState$ = _useState[0],
  count = _useState$ === undefined ? 3 : _useState$,
  setCount = _useState[1]

Oooh, fancy, so if the first element of the array is undefined, then we'll set count to 3 instead. Default values! Sweet.

Note: most of the things above you would never need to do with useState because we can always rely on useState returning an array of two elements! We'll look at that more next.

Ok cool, so this helps us understand what's actually going on. There's nothing React-specific about this syntax. It's built-into the JavaScript specification, and React's useState hook is leveraging it as a mechanism for an ergonomic API that allows you to get two values out of a single function call. Neat!

Ok, so what does useState actually do then? What is it really returning? It must be returning an array for us to be doing the array destructuring like this right? Cool, let's check that out.

One thing that's interesting is that the implementation of useState exists within react-dom rather than react. I know, that may be confusing because we import useState from the react package, but it actually just delegates to the current renderer (which is react-dom in our situation here). In fact, setState is the same way!

Another interesting thing about useState is that the implementation in react-dom is just a few lines:

function useState(initialState) {
  return useReducer(
    basicStateReducer,
    // useReducer has a special case to support lazy useState initializers
    initialState,
  )
}

😱 it's actually just a hook that's using the useReducer hook! Ok, but what is that basicStateReducer thing huh?

function basicStateReducer(state, action) {
  return typeof action === 'function' ? action(state) : action
}

Ok, interesting, so useReducer is actually over 100 lines of code, so let's just look at what useReducer returns:

return [newState, dispatch]

See! It's an array! So when we call useState, it returns a call to useReducer which will return an array of two values. This allows us to do the array destructuring that we want so instead of writing:

const stateAndUpdater = useState(0)
const count = stateAndUpdater[0]
const setCount = stateAndUpdater[1]

We can write:

const [count, setCount] = useState(0)

Nice!

Conclusion

I hope you found this one helpful! Even if you already are very familiar with destructing syntax, the process of learning new syntax I show above has been helpful to me as recently as Friday when I was playing around with TypeScript. Seeing syntax that I'm not familiar with and learning new things is something that I'll never get tired of in this industry! And learning the fundamentals behind these bits of syntax will make you more effective at using them. I should mention also that there are more things you can do with destructuring and if you're interested there's a section about destructuring in my ES6 workshop that's available completely free on my YouTube channel. Good luck!

Epic React

Get Really Good at React

Illustration of a Rocket
Kent C. Dodds
Written by Kent C. Dodds

Kent C. Dodds is a JavaScript software engineer and teacher. Kent's taught hundreds of thousands of people how to make the world a better place with quality software development tools and practices. He lives with his wife and four kids in Utah.

Learn more about Kent

If you found this article helpful.

You will love these ones as well.