DEV Community

Cover image for JSByte: JavaScript Optional Chaining `?.` Explained - How it Works and When to Use it
Shruti Kapoor
Shruti Kapoor

Posted on • Updated on • Originally published at freecodecamp.org

JSByte: JavaScript Optional Chaining `?.` Explained - How it Works and When to Use it

What is it?

Optional chaining ?. in javascript is a new feature introduced in ES2020. Optional chaining changes the way properties are accessed from deeply nested objects. It fixes the problem of having to do multiple null checks when accessing long chain of object properties in javascript.

Current Status: ECMAScript proposal at stage 4 of the process. : https://github.com/tc39/proposal-optional-chaining

Use cases

  1. Accessing potentially null or undefined properties of an object.
  2. Getting results from a variable that may not be available yet.
  3. Getting default values.
  4. Accessing long chain of properties.

Imagine you are expecting an API to return an object of this sort.

obj = {
  prop1: {
    prop2: {
      someProp: "value"
    }
  }
};
Enter fullscreen mode Exit fullscreen mode

But, you may not know if each of these fields are available ahead of time, since some of these fields may not have been sent back by the API, or they may come back with null values. Here is an example -

//expected
obj = {
  id: 9216,
  children: [
    { id: 123, children: null },
    { id: 124, children: [{ id: 1233, children: null }] }
  ]
};

//actual
obj = {
  id: 9216,
  children: null
};
Enter fullscreen mode Exit fullscreen mode

This happens very often with functions that call APIs. You may have seen code in React that tries to safeguard against these issues like this -

render = () => {
  const obj = {
    prop1: {
      prop2: {
        someProp: "value",
      },
    },
  };

  return (
    <div>
      {obj && obj.prop1 && obj.prop1.prop2 && obj.prop1.prop2.someProp && (
        <div>{obj.prop1.prop2.someProp}</div>
      )}
    </div>
  );
};

Enter fullscreen mode Exit fullscreen mode

In order to better prepare for this issue, often times in the past we have used Lodash.js, specifically the _.get method.

_.get(obj, prop1.prop2.someProp);

Enter fullscreen mode Exit fullscreen mode

which gives undefined if either of those properties are undefined. Optional chaining is exactly that! Now instead of using an external library, this functionality is in-built!

How does optional chaining work?

?. can be used to chain properties that may be null or undefined.

const propNeeded = obj?.prop1?.prop2?.someProp;

Enter fullscreen mode Exit fullscreen mode

If either of those chained properties is null or undefined, javascript will return undefined. What if we want to return something meaningful? Try this -

let familyTree = {
    us: {
        children: {}
    }
}


// with _.get
const grandChildren = _.get(familyTree, 'us.children.theirChildren', 'got no kids' );

//with optional chaining and null coalescing 
const nullCoalescing = familyTree?.us?.children?.theirChildren ?? 'got no kids'
console.log(nullCoalescing) //got no kids

Enter fullscreen mode Exit fullscreen mode

It also works for objects that may be null or undefined

let user;
console.log(user?.id) // undefined

Enter fullscreen mode Exit fullscreen mode

How to try out this new feature

  1. In your browser's console
    This is a recent addition and old browsers may need polyfills. You can try it in chrome or firefox in the browser's console. If it doesn't work, try turning on javascript experimental features by visiting chrome://flags/ and enabling "Experimental JavaScript".

  2. In your node app
    By using babel -

{
  "plugins": ["@babel/plugin-proposal-optional-chaining"]
}
Enter fullscreen mode Exit fullscreen mode

Resources

  1. https://dmitripavlutin.com/javascript-optional-chaining/
  2. Babel's doc: https://babeljs.io/docs/en/babel-plugin-proposal-optional-chaining

TL;DR

Use optional chaining ?. for objects or long chain properties that may be null or undefined. The syntax is -

let user = {};
console.log(user?.id?.name) 
Enter fullscreen mode Exit fullscreen mode

Interested in more tutorials and JSBytes from me? Sign up for my newsletter. or follow me on Twitter

Top comments (0)