Event Handlers and Callback Functions in JavaScript

In Higher Order Programming in Javascript I discussed the various ways of using functions as values. One particular trick in that document caught the attention of Dan Shappir, who pointed out to me: "your technique shows how JavaScript supported delegates all along, so this is not some great C#/.NET invention." While searching for some more information about these delegates, I found out that Microsoft has added them to Visual J++ too, invoking an interesting response from Sun, where it's discussed how delegates can much better be implemented with Inner Classes. As this is aparently a hot issue in other languages, and because event handlers and callbacks are useful in webpages too, I decided to write a new article to discuss this.

The problem is as follows: Methods use this to refer to the object it is a method of. But, when using a method as event handler or callback function, this does no longer point to that object. The trick is to use the closure like behaviour of functions, so that the method will always have access to it's object.

Let's look at an example: We want to use a method of an Alerter class as an event handler.

So, instead of using this, we use a variable me, that equals this when the invoke method is created. And, in contrast to this, me will keep refering to the correct Alerter object, even when it's passed as a function to the attachEvent method of an HTML element.

window.setTimeout is an often used function for dynamic webpages. It waits for a given amount of time, and then calls a callback function. The above defined sayHi function can be used as a callback function: setTimeout(sayHi.invoke,2000) will show an alert box after 2 seconds. But what if we want to be extra cool and show 2 alert boxes after those 2 seconds? Then we'd have to create a new function that calls both Alerter objects:

var sayHi=new Alerter('Hello, world!');  

var sayBye=new Alerter('Bye, world!');

setTimeout(function() {sayHi.invoke();sayBye.invoke();},2000);

A nice feature of Microsoft's delegates is that you can create a single composite deligate from several delegates. It looks less messy than inserting an anonymous function. Let's do that in Javascript too, by extending the function prototype.

Function.prototype.andThen=function(g) {

  var f=this;

  return function() {

    f();g();

  }

};

Now we can write:

setTimeout((sayHi.invoke).andThen(sayBye.invoke),2000);

Several callbacks

With the andThen method, it becomes very easy to create an object that allows several other objects to register callbacks.

function Manager() {

  this.callback=function () {}; // do nothing

  this.registerCallback=function(callbackFunction) {

    this.callback=(this.callback).andThen(callbackFunction);

  }

}

 

var manager=new Manager();

manager.registerCallback(sayHi.invoke);

manager.registerCallback(sayBye.invoke);

manager.callback();