Course contentsShow
← JavaScript
Lesson 656 of 2,72316. Object Methods and PatternsFree lesson

Method Chaining and Returning 'this'

Implement fluent interfaces by returning 'this' from methods to enable method chaining.

Method Chaining and Returning 'this'

You'll learn how to make objects "chainable" by returning this from their methods, enabling elegant one-liner sequences.

The Core Idea

When a method returns this, it gives back the object itself. This allows you to immediately call another method on the result, then another, and another—all in one continuous expression. This pattern is called method chaining or a fluent interface.

Think of it like a relay race: each runner (method) passes the baton (this) to the next runner, keeping the momentum going without pause.

How It Works

Normally, methods perform an action but don't return anything useful:

const calculator = {
  value: 0,
  add(n) {
    this.value += n;
    // No return statement = undefined returned
  }
};

calculator.add(5);
calculator.add(10); // Must call separately

By returning this, you enable chaining:

const calculator = {
  value: 0,
  add(n) {
    this.value += n;
    return this; // Returns the object itself
  },
  multiply(n) {
    this.value *= n;
    return this;
  }
};

calculator.add(5).multiply(2).add(3); // All in one line!
console.log(calculator.value); // 13

Each method call returns the calculator object, so the next method can be called immediately on that result.

Why It's Useful

Method chaining creates more readable, expressive code. Instead of repetitive variable references, you write flowing sequences that describe what you're doing step-by-step.

Key Takeaway: Returning this from object methods enables method chaining, allowing multiple method calls in sequence for cleaner, more fluent code.