Add Object Specifier (ES5 + ES6 + CoffeeScript + TypeScript)

Author: Badacadabra

misc/ObjectSpecifier/CoffeeScript/index.coffee

@@ -0,0 +1,17 @@
+profile = (person) ->
+    """
+    First name: #{person.firstName}
+    Last name: #{person.lastName}
+    Age: #{person.age}
+    Gender: #{person.gender}
+    Nationality: #{person.nationality}
+    """
+
+myProfile = profile
+    nationality: "French"
+    gender: "M"
+    firstName: "Baptiste"
+    lastName: "Vannesson"
+    age: 27
+
+console.log myProfile

misc/ObjectSpecifier/ECMAScript/ES5/index.js

@@ -0,0 +1,19 @@
+var profile = function (person) {
+    var str = "";
+        str += "First name: " + person.firstName;
+        str += "\nLast name: " + person.lastName;
+        str += "\nAge: " + person.age;
+        str += "\nGender: " + person.gender;
+        str += "\nNationality: " + person.nationality;
+    return str;
+};
+
+var myProfile = profile({
+    nationality: "French",
+    gender: "M",
+    firstName: "Baptiste",
+    lastName: "Vannesson",
+    age: 27
+});
+
+console.log(myProfile);

misc/ObjectSpecifier/ECMAScript/ES6/index.js

@@ -0,0 +1,15 @@
+const profile = ({ firstName, lastName, age, gender, nationality }) => `First name: ${firstName}
+Last name: ${lastName}
+Age: ${age}
+Gender: ${gender}
+Nationality: ${nationality}`
+
+let myProfile = profile({
+    nationality: "French",
+    gender: "M",
+    firstName: "Baptiste",
+    lastName: "Vannesson",
+    age: 27
+});
+
+console.log(myProfile);

misc/ObjectSpecifier/README.md

@@ -0,0 +1,10 @@
+# Problem
+
+Functions may have a high arity, which means that they can accept a lot of arguments. This is not optimal for at least two reasons:
+
+  1. Keeping a nice-looking indentation is hard if the list of parameters is really long
+  2. It is difficult for the programmer to remember the order of many positional parameters 
+
+# Solution
+
+An object specifier (a.k.a. options object) is a simple object literal that is passed to a function instead of a long series of arguments. In other words, when a function has lots of formal parameters in its signature, it is generally a good idea to refactor it and give it only one parameter (that will be the object specifier). The good point with this pattern is that it allows named parameters instead of positional parameters, so that the order is not even a problem anymore.

misc/ObjectSpecifier/TypeScript/index.ts

@@ -0,0 +1,23 @@
+interface Person {
+    firstName: string;
+    lastName: string;
+    age: number;
+    gender: string;
+    nationality: string;
+}
+
+const profile = (person: Person) => `First name: ${person.firstName}
+Last name: ${person.lastName}
+Age: ${person.age}
+Gender: ${person.gender}
+Nationality: ${person.nationality}`
+
+let myProfile: string = profile({
+    nationality: "French",
+    gender: "M",
+    firstName: "Baptiste",
+    lastName: "Vannesson",
+    age: 27
+});
+
+console.log(myProfile);