Using the Fluent Interface Pattern to Create JavaScript Objects
Nick Scialli (he/him)
Posted on April 26, 2020
There are many ways to create new JavaScript objects. In this post, we'll use the fluent interface pattern! In the fluent interface pattern, we use classes with defined methods to add attributes to our object.
In the following example, we create a PersonBuilder
class. In the constructor
, we create an empty person
property. Then, we have some additional methods called withName
and withAge
that allow us to give our person a name and age, respectively.
Finally, we have a build
method. This just returns our person
object, signifying that we're done building.
class PersonBuilder {
constructor() {
this.person = {};
}
withName(name) {
this.person.name = name;
return this;
}
withAge(age) {
this.person.age = age;
return this;
}
build() {
return this.person;
}
}
Note that we return this
in the withName
and withAge
methods--this returns the current instance, allowing us to continue to chain methods.
The implementation of our class ends up being something like this:
const person = new PersonBuilder()
.withName("Daffodil")
.withAge(25)
.build();
console.log(person);
// { name: "Daffodil", age: 25 }
And that's it, we now have a person object!
Why Build Objects This Way?
The fluent interface pattern can definitely be verbose, but one nice thing about it is that it makes it pretty hard to set an incorrect property on your object--you can only set object props by using the methods on your class. This can be especially handy if your object has a lot of properties, or if you need a handy way to generate a bunch of different objects to a specification (e.g., for test case generation).
Posted on April 26, 2020
Join Our Newsletter. No Spam, Only the good stuff.
Sign up to receive the latest update from our blog.