DEV Community

Cover image for Mastering the 'this' Keyword in JavaScript: Never to look back again
Saurabh Raj
Saurabh Raj

Posted on

Mastering the 'this' Keyword in JavaScript: Never to look back again

JavaScript’s this keyword is a fundamental concept that often puzzles both beginners and seasoned developers alike. Its dynamic nature can lead to unexpected behaviors if not thoroughly understood. This comprehensive guide aims to demystify this, exploring its various contexts, nuances, and best practices, complete with illustrative examples and challenging problems to solidify your understanding.

Introduction to this

In JavaScript, this is a keyword that refers to the object from which the current code is being executed. Unlike some other programming languages where this is statically bound, JavaScript’s this is dynamically determined based on how a function is called.

1. Global Context

When not inside any function, this refers to the global object.

  • In Browsers: The global object is window.
  • In Node.js: The global object is global.

Example

console.log(this === window); // true (in browser)
console.log(this === global); // true (in Node.js)
Enter fullscreen mode Exit fullscreen mode

Note: In strict mode ('use strict';), this in the global context remains the global object.

2. Function Context

I. Regular Functions

In regular functions, this is determined by how the function is called.

  • Default Binding: If a function is called without any context, this refers to the global object (or undefined in strict mode).

Example:

function showThis() {
  console.log(this);
}

showThis(); // Window object (in browser) or global (in Node.js)
Enter fullscreen mode Exit fullscreen mode
  • Implicit Binding: When a function is called as a method of an object, this refers to that object.

Example

const person = {
  name: 'Alice',
  greet: function() {
    console.log(`Hello, I'm ${this.name}`);
  }
};

person.greet(); // "Hello, I'm Alice"
Enter fullscreen mode Exit fullscreen mode

We can use call, apply, or bind to explicitly set this.

function greet() {
  console.log(`Hello, I'm ${this.name}`);
}

const person = { name: 'Bob' };
greet.call(person); // "Hello, I'm Bob"
Enter fullscreen mode Exit fullscreen mode

II. Arrow Functions

Arrow functions have a lexical this, meaning they inherit this from the surrounding scope at the time of their creation.

Example

const person = {
  name: 'Charlie',
  greet: () => {
    console.log(`Hello, I'm ${this.name}`);
  }
};

person.greet(); // "Hello, I'm undefined" (or global name if defined)
Enter fullscreen mode Exit fullscreen mode

Explanation: Since arrow functions do not have their own this, this refers to the global object, not the person object.

Correct Usage with Arrow Functions:

const person = {
  name: 'Dana',
  greet: function() {
    const inner = () => {
      console.log(`Hello, I'm ${this.name}`);
    };
    inner();
  }
};

person.greet(); // "Hello, I'm Dana"
Enter fullscreen mode Exit fullscreen mode

Challenging Aspect: If a method is assigned to a variable and called, this may lose its intended context.
Example

const calculator = {
  value: 0,
  add: function(num) {
    this.value += num;
    return this.value;
  }
};

console.log(calculator.add(5)); // 5
console.log(calculator.add(10)); // 15

const addFunction = calculator.add;
console.log(addFunction(5)); // NaN (in non-strict mode, this.value is undefined + 5)
Enter fullscreen mode Exit fullscreen mode

3. Constructor Functions and this

When a function is used as a constructor with the new keyword, this refers to the newly created instance.

function Person(name) {
  this.name = name;
}

const alice = new Person('Alice');
console.log(alice.name); // "Alice"
Enter fullscreen mode Exit fullscreen mode

Important Notes:
• If new is not used, this might refer to the global object or be undefined in strict mode.
• Constructors typically capitalize the first letter to distinguish them from regular functions.

4. The this in Event Handlers

In event handlers, this refers to the element that received the event.

Example

<button id="myButton">Click me</button>
<script>
  const button = document.getElementById('myButton');
  button.addEventListener('click', function() {
    console.log(this); // <button id="myButton">Click me</button>
  });
</script>
Enter fullscreen mode Exit fullscreen mode

Arrow Function Caveat:
Using arrow functions in event handlers can lead to this referring to the surrounding scope instead of the event target.
Example:

button.addEventListener('click', () => {
  console.log(this); // Global object or enclosing scope
});
Enter fullscreen mode Exit fullscreen mode

5. Explicit Binding with call, apply, and bind

JavaScript provides methods to explicitly set the value of this:

  • call: Invokes the function with this set to the first argument, followed by function arguments.
function greet(greeting) {
  console.log(`${greeting}, I'm ${this.name}`);
}

const person = { name: 'Eve' };
greet.call(person, 'Hello'); // "Hello, I'm Eve"
Enter fullscreen mode Exit fullscreen mode
  • apply: Similar to call, but accepts arguments as an array.
greet.apply(person, ['Hi']); // "Hi, I'm Eve"
Enter fullscreen mode Exit fullscreen mode
  • bind: Returns a new function with this bound to the first argument.
const boundGreet = greet.bind(person);
boundGreet('Hey'); // "Hey, I'm Eve"
Enter fullscreen mode Exit fullscreen mode

Use Cases:

  • Borrowing methods from other objects.
  • Ensuring this remains consistent in callbacks.

6. this in Classes

ES6 introduced classes, which provide a clearer syntax for constructor functions and methods. Within class methods, this refers to the instance.
Exmaple:

class Animal {
  constructor(name) {
    this.name = name;
  }

  speak() {
    console.log(`${this.name} makes a noise.`);
  }
}

const dog = new Animal('Dog');
dog.speak(); // "Dog makes a noise."
Enter fullscreen mode Exit fullscreen mode

Arrow Functions in Classes:
Arrow functions can be used for methods to inherit this from the class context, useful for callbacks.

class Person {
  constructor(name) {
    this.name = name;
  }

  greet = () => {
    console.log(`Hello, I'm ${this.name}`);
  }
}

const john = new Person('John');
john.greet(); // "Hello, I'm John"
Enter fullscreen mode Exit fullscreen mode

Common Pitfalls and Best Practices

I. Losing this Context

When passing methods as callbacks, the original context may be lost.
Problem

const obj = {
  name: 'Object',
  getName: function() {
    return this.name;
  }
};

const getName = obj.getName;
console.log(getName()); // undefined or global name
Enter fullscreen mode Exit fullscreen mode

Solution
Use bind to preserve context.

const boundGetName = obj.getName.bind(obj);
console.log(boundGetName()); // "Object"
Enter fullscreen mode Exit fullscreen mode

II. Using Arrow Functions Improperly

Arrow functions don’t have their own this, which can lead to unexpected behavior when used as methods.

Problem

const obj = {
  name: 'Object',
  getName: () => {
    return this.name;
  }
};

console.log(obj.getName()); // undefined or global name
Enter fullscreen mode Exit fullscreen mode

Solution
Use regular functions for object methods.

const obj = {
  name: 'Object',
  getName: function() {
    return this.name;
  }
};

Enter fullscreen mode Exit fullscreen mode

III. Avoiding Global this

Unintentionally setting properties on the global object can lead to bugs.

Problem

function setName(name) {
  this.name = name;
}

setName('Global');
console.log(window.name); // "Global" (in browser)
Enter fullscreen mode Exit fullscreen mode

Solution
Use strict mode or proper binding.

'use strict';
function setName(name) {
  this.name = name;
}

setName('Global'); // TypeError: Cannot set property 'name' of undefined
Enter fullscreen mode Exit fullscreen mode

Advanced Concepts

I. this in Nested Functions

In nested functions, this may not refer to the outer this. Solutions include using arrow functions or storing this in a variable.
Example with Arrow Function:

const obj = {
  name: 'Outer',
  nested: function() {
    const inner = () => {
      console.log(this.name);
    };
    inner();
  }
};

obj.nested(); // "Outer"
Enter fullscreen mode Exit fullscreen mode

Example with Variable:

const obj = {
  name: 'Outer',
  nested: function() {
    const self = this;
    function inner() {
      console.log(self.name);
    }
    inner();
  }
};

obj.nested(); // "Outer"
Enter fullscreen mode Exit fullscreen mode

II. this with Prototypes

When using prototypes, this refers to the instance.

function Person(name) {
  this.name = name;
}

Person.prototype.greet = function() {
  console.log(`Hi, I'm ${this.name}`);
};

const alice = new Person('Alice');
alice.greet(); // "Hi, I'm Alice"
Enter fullscreen mode Exit fullscreen mode

Conclusion

The this keyword in JavaScript is a versatile and powerful feature that, when understood correctly, can greatly enhance your coding capabilities.


10 Tricky Problems to Master this

To truly cement your understanding of this, tackle the following challenging problems. Each problem is designed to test different aspects and edge cases of the this keyword in JavaScript. Solutions in the end.

Problem 1: The Mysterious Output

var name = 'Global';

const person = {
  name: 'Alice',
  getName: function() {
    return this.name;
  }
};

const getName = person.getName;
console.log(getName()); // What is the output?
Enter fullscreen mode Exit fullscreen mode

Problem 2: Arrow Function Surprise

const name = 'Global';

const person = {
  name: 'Bob',
  greet: () => {
    console.log(`Hello, I'm ${this.name}`);
  }
};

person.greet(); // What is printed?
Enter fullscreen mode Exit fullscreen mode

Problem 3: Binding this in a Callback

function Timer() {
  this.seconds = 0;

  setInterval(function() {
    this.seconds++;
  }, 1000);
}

const timer = new Timer();
setTimeout(() => {
  console.log(timer.seconds); // What is the expected output after 3 seconds?
}, 3000);
Enter fullscreen mode Exit fullscreen mode

Problem 4: Using bind Correctly

const module = {
  x: 42,
  getX: function() {
    return this.x;
  }
};

const retrieveX = module.getX;
console.log(retrieveX()); // Undefined

const boundGetX = retrieveX.bind(module);
console.log(boundGetX()); // What is the output?
Enter fullscreen mode Exit fullscreen mode

Problem 5: this in Constructor Functions

function Car(model) {
  this.model = model;
  this.getModel = () => {
    return this.model;
  };
}

const car = new Car('Tesla');
const getModel = car.getModel;
console.log(getModel()); // What does this print?
Enter fullscreen mode Exit fullscreen mode

Problem 6: Event Handler Context

<button id="myButton">Click Me</button>
<script>
  const obj = {
    name: 'Button',
    handleClick: function() {
      console.log(this.name);
    }
  };

  const button = document.getElementById('myButton');
  button.addEventListener('click', obj.handleClick);
</script>
Enter fullscreen mode Exit fullscreen mode

Problem 7: Nested Functions and this

const obj = {
  name: 'Outer',
  outerFunc: function() {
    console.log(this.name); // What does this print?

    function innerFunc() {
      console.log(this.name); // What does this print?
    }

    innerFunc();
  }
};

obj.outerFunc();
Enter fullscreen mode Exit fullscreen mode

Problem 8: this in Promises

const obj = {
  value: 100,
  getValue: function() {
    return new Promise(function(resolve, reject) {
      resolve(this.value);
    });
  }
};

obj.getValue().then(function(val) {
  console.log(val); // What is logged?
});
Enter fullscreen mode Exit fullscreen mode

Problem 9: Chaining with bind

function multiply(a, b) {
  return a * b;
}

const double = multiply.bind(null, 2);
console.log(double(5)); // What is the output?
Enter fullscreen mode Exit fullscreen mode

Problem 10: this with Classes and Inheritance

class Animal {
  constructor(name) {
    this.name = name;
  }

  speak() {
    console.log(`${this.name} makes a noise.`);
  }
}

class Dog extends Animal {
  speak() {
    setTimeout(function() {
      console.log(`${this.name} barks.`);
    }, 1000);
  }
}

const dog = new Dog('Rex');
dog.speak(); // What is printed after 1 second?
Enter fullscreen mode Exit fullscreen mode

Solutions to Tricky Problems

Solution to Problem 1:

When getName is assigned to a variable and called without any object context, this defaults to the global object. In non-strict mode, this.name refers to the global name, which is 'Global'. In strict mode, this would be undefined, leading to an error.

console.log(getName()); // "Global"
Enter fullscreen mode Exit fullscreen mode

Solution to Problem 2:

Arrow functions do not have their own this; they inherit it from the surrounding scope. In this case, the surrounding scope is the global context, where this.name is 'Global'.

person.greet(); // "Hello, I'm Global"
Enter fullscreen mode Exit fullscreen mode

Solution to Problem 3:

Inside the setInterval callback, this refers to the global object (or is undefined in strict mode). Thus, this.seconds++ either increments window.seconds or throws an error in strict mode. The timer.seconds remains 0.

console.log(timer.seconds); // 0
Enter fullscreen mode Exit fullscreen mode

Solution to Problem 4:

After binding retrieveX to module, calling boundGetX() correctly sets this to module.

console.log(boundGetX()); // 42
Enter fullscreen mode Exit fullscreen mode

Solution to Problem 5:

The arrow function getModel inherits this from the constructor, which refers to the newly created car instance.

console.log(getModel()); // "Tesla"
Enter fullscreen mode Exit fullscreen mode

Solution to Problem 6:

In event handlers using regular functions, this refers to the DOM element that received the event, which is the button. Since the button doesn’t have a name property, this.name is undefined.

// Logs undefined
Enter fullscreen mode Exit fullscreen mode

Solution to Problem 7:

  • First console.log(this.name); inside outerFunc refers to obj, so it prints 'Outer'.
  • Second console.log(this.name); inside innerFunc refers to the global object, so it prints 'Global' or undefined in strict mode.
// "Outer"
// "Global" (or undefined in strict mode)
Enter fullscreen mode Exit fullscreen mode

Solution to Problem 8:

Inside the Promise constructor, this refers to the global object (or is undefined in strict mode). Thus, this.value is undefined (or causes an error in strict mode).

console.log(val); // undefined
Enter fullscreen mode Exit fullscreen mode

Solution to Problem 9:

The multiply function is bound with the first argument a as 2. When double(5) is called, it effectively computes multiply(2, 5).

console.log(double(5)); // 10
Enter fullscreen mode Exit fullscreen mode

Solution to Problem 10:

In the Dog class’s speak method, the setTimeout callback is a regular function. Thus, this inside the callback refers to the global object, not the dog instance. this.name is 'undefined' or causes an error if name is not defined globally.

// After 1 second, logs: "undefined barks."
Enter fullscreen mode Exit fullscreen mode

To fix this, use an arrow function:

speak() {
  setTimeout(() => {
    console.log(`${this.name} barks.`);
  }, 1000);
}
Enter fullscreen mode Exit fullscreen mode

Now, it correctly logs:

// "Rex barks."
Enter fullscreen mode Exit fullscreen mode

Top comments (0)