Implement callback when script finishes running in V8 API.

Implement callback when script finishes running in V8 API.

TEST=test-api/LeaveScriptCallback

Committed: http://code.google.com/p/v8/source/detail?r=10323

[Yang, 2011-12-13 12:49:15]

PTAL.

Suggestions for a different naming scheme are also welcome.

[Yang, 2011-12-15 10:32:57]

On 2011/12/13 12:49:15, Yang wrote:
> PTAL.
> 
> Suggestions for a different naming scheme are also welcome.

Please take another look.

[Yang, 2011-12-16 12:21:08]

I think I might have dealt with the exception issue without too much effort.
Instead of doing it before or after the exception handling block, I do it inside
it, so that after the uncaught exception has been handled but before bailing
out, we fire callbacks. At the point where we do the callbacks, there are no
pending exceptions anymore. I extended the cctest in test-api.cc to demonstrate.

I also changed the call depth counter to be tied to the isolate so that multiple
threads calling into V8 do not cause confusion.

[Yang, 2012-01-02 17:51:15]

On 2011/12/16 12:21:08, Yang wrote:
> I think I might have dealt with the exception issue without too much effort.
> Instead of doing it before or after the exception handling block, I do it
inside
> it, so that after the uncaught exception has been handled but before bailing
> out, we fire callbacks. At the point where we do the callbacks, there are no
> pending exceptions anymore. I extended the cctest in test-api.cc to
demonstrate.
> 
> I also changed the call depth counter to be tied to the isolate so that
multiple
> threads calling into V8 do not cause confusion.

*nudge*

[danno, 2012-01-03 15:35:11]

http://codereview.chromium.org/8937003/diff/14001/include/v8.h
File include/v8.h (right):

http://codereview.chromium.org/8937003/diff/14001/include/v8.h#newcode3046
include/v8.h:3046: * running.  In case of recursive scripts, the callback is
only triggered
"recursive" is a bit misleading. How about "If a script re-enters the runtime
from a callback during executing, the CallCompletedCallback is only invoked when
the outer-most script execution ends.

[Yang, 2012-01-04 08:13:36]

Changed/fixed comments.

[danno, 2012-01-04 08:38:48]

LGTM with tiny nits

http://codereview.chromium.org/8937003/diff/19001/include/v8.h
File include/v8.h (right):

http://codereview.chromium.org/8937003/diff/19001/include/v8.h#newcode3054
include/v8.h:3054: * This function removes callback which was installed by
Just: Removes callback that was installed by AddCallCompletedCallback function

http://codereview.chromium.org/8937003/diff/19001/src/v8.h
File src/v8.h (right):

http://codereview.chromium.org/8937003/diff/19001/src/v8.h#newcode130
src/v8.h:130: // List of callbacks when a call completes.
s/call/Call