Creating and Testing a CoffeeScript ES6‑like Class in Node.js

Desired outcome

Define a simple class in CoffeeScript, compile it to plain JavaScript, and verify that the compiled module works correctly in a Node.js environment, including proper this binding in instance methods.

Prerequisites

1. Node.js version 12 or newer installed (node --version).
2. CoffeeScript installed globally via npm (npm install -g coffeescript).
3. A terminal or command prompt with access to the node and coffee executables.

Procedure

1. Create the CoffeeScript class file.

   # Person.coffee
   class Person
     constructor: (@name, @age) ->
   
     greet: ->
       "Hello, I am #{@name} and I am #{@age} years old."
   
     # Using fat arrow to lexically bind `this` for callbacks
     yearlyUpdate: (callback) ->
       setTimeout () =>
         @age += 1
         callback @age
       , 100
   
   # Export for Node.js
   module.exports = Person
   

   Save this as Person.coffee in an empty project folder.

2. Compile to JavaScript.

   coffee -c Person.coffee

   This generates Person.js in the same directory.

3. Inspect the generated JavaScript (optional but recommended).

   Open Person.js and verify that the class is transpiled to a constructor function with methods placed on its prototype, and that the fat arrow (=>) produces a lexical this binding inside the setTimeout callback.

4. Create a test script.

   // test.js
   const Person = require('./Person');
   
   const p = new Person('Ada', 30);
   console.log(p.greet());
   
   p.yearlyUpdate((newAge) => {
     console.log(`After update: age is ${newAge}`);
   });
   

   Save as test.js.

5. Run the test with Node.js.

   node test.js

   Observe the console output.

Expected checks

• The compiled Person.js should contain a constructor function named Person and prototype methods greet and yearlyUpdate.
• Running node test.js should print a greeting line similar to:
• "Hello, I am Ada and I am 30 years old."
• After approximately 100 ms, a second line should appear indicating the updated age, e.g., After update: age is 31.
• If the output matches the expected pattern, the class and its methods are correctly bound and executed.

Recovery options

1. Indentation errors. CoffeeScript is whitespace‑sensitive. If compilation fails, re‑check that each level of indentation uses spaces (or tabs) consistently and that no stray whitespace appears at the start of lines.
2. Incorrect this binding. Ensure that callbacks needing the instance use the fat arrow (=>) rather than the thin arrow (->). Switching to => will bind this lexically to the class instance.
3. Node version incompatibility. The generated JavaScript uses ES2015 features (e.g., let, arrow functions). If you run an older Node (< 4) that lacks support, either upgrade Node or transpile the output further with a tool like Babel.
4. Cleaning generated files. To start over, delete Person.js (and any *.map files if you generated source maps) and repeat the compile step.