Learn to code by coding - try our free CS courses

Singletons in ES6 – The Good, The Bad, The Ugly

Singletons are fairly controversial as far as I can tell, especially in JavaScript programming. Let’s take a look at what they are, when to (maybe) use them, and when not to.

Start your coding adventure today

Our interactive Intro to JavaScript course starts right from the basics, giving you all the tools you need to become a proficient programmer. You’ll code your own adventure video game, and write real code as you earn your first certificate.

What is a Singleton?

A singleton is a class that allows only a single instance of itself to be created and gives access to that created instance. It contains static variables that can accommodate unique and private instances of itself. We use it in scenarios when a user wants to restrict instantiation of a class to only one object. This is helpful usually when a single object is required to coordinate actions across a system.


Usually, in object-oriented programming, the idea is to define classes and create multiple instances of that class, each with their own state. This keeps code DRY and easy to maintain.

By contrast, it only instantiates a singleton once, and therefore any code that accesses the singleton will either:

  • Create a new instance
  • Read, update, or modify that instance

Which means a singleton is almost a global instance of a class. Gross.

I Can’t Believe It’s Not Global!

For the purpose of this article, we will assume we are using ES6 modules in our front-end React or Vue project. An example of a singleton we might want could be:

// Define our state and initialize it let darkMode = false; // Define the functions that will expose that state const Settings = { setDarkMode: (newVal) => darkMode = newVal, getDarkMode: () => darkMode, } // Disallow new properties on our object Object.freeze(Settings); export default Settings;
Code language: JavaScript (javascript)

As stated earlier, a singleton is dangerously close to being a global variable, and we don’t like those. There is one important difference:

The singleton instance isn’t actually globally scoped: in order to modify state the caller must import the class and use getters/setters. This makes access more explicit and controlled. Not only are the ways in which the state can be modified explicitly defined, but files that use the state must ‘import’ it.

But Muh Redux

Here’s my over-simplified opinion in the form of a flowchart:


The idea is to use the simplest, most-controlled solution we reasonably can. In order of least evil –> most evil:

  • scoped constants
  • scoped variables
  • singletons
  • redux/vuex
  • global variables

Singletons Suck

Redux, Vuex, singletons, and global variables all suck. Try not to use them. I’m just trying to point out that they all suck to varying degrees. Good luck.

Have questions or feedback?

Follow and hit me up on Twitter @q_vault if you have any questions or comments. If I’ve made a mistake in the article, please let me know so I can get it corrected!

Related Reading