Version 2.x

This is a convenience function to weave an after advice based on advise().

Description

This is a shortcut function to weave one after advice with an object’s method. Logically it is defined as:

1
2
3
4
5

advise.after = function(object, name, advice){
  return advise(object, name, {
    after: advice
  });
};

It means that instead of:

1
2
3

var adv = advise(object, name, {
  after: advice
});

It is possible to write a shorter version:

1

var adv = advise.after(object, name, advice);

Advice function

This is a regular function. It is called with the same context as an advised method. It takes up to four parameters:

• args - the arguments object (a pseudo-array) used to call an advised method.
• result - the returned value or a thrown exception object.
• makeReturn(value) - the procedure, which can be called to supply a new returned value.
• makeThrow(value) - the procedure, which can be called to emulate an exception. In this case value is assumed to be a valid exception value, e.g., an Error object.

Both makeReturn() and makeThrow() can be called several times. The last value is used as the result.

The returned value of an after advice is ignored.

It is not recommended to modify parameters or a returned value inside after advice. Use makeReturn(), or makeThrow() for that. Or consider using around advice.

It is recommended to derive all exception objects from the standard Error object, so erroneous and normal result values would be easily distinguished.

Returned value

Just like advise() it is based on, it returns the object, which defines the method unadvise(). When called without parameters, it removes the corresponding advice from the object, no matter when it was defined. For convenience, this method is aliased as remove(), and destroy().