Javascript Promises are cool new feature of Javascript. A promise is a result of an asynchronous operation. It can be one of the three states.

  • Pending: The initial state of a promise. That means it’s processing.
  • Fulfilled: The operation is successful.
  • Rejected: The operation is failed.

Let’s consider a code snippet below:

fs.readFile(filename, enc, function (err, res){
  // do our things here

If we are using generator based flow control this function should be thunkified (thunkify module or similar wrapper) first. But we can implement a Promise and make it generator friendly, which is more convenient in many ways. Let’s have a look at the code snippet below:

function readFile(filename, enc) {
  return new Promise(function(fulfill, reject) {
    fs.readFile(filename, enc, function(err, res) {
      if (err) {
      } else {

Now this readFile is generator based flow control friendly. Whenever we need to read file we can simply do it in modern way:

var data = yield readFile(filename, enc);

That’s it, using promises are simple and pretty fun. We will see how to chain events with Javascript Promises in the next article.