Package org.mozilla.javascript.debug

Interface DebugFrame

  • All Known Implementing Classes:
    Dim.StackFrame
    public interface DebugFrame
    Interface to implement if the application is interested in receiving debug information during execution of a particular script or function.

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void onDebuggerStatement​(Context cx)
      Called when the function or script executes a 'debugger' statement.
      void onEnter​(Context cx, Scriptable activation, Scriptable thisObj, java.lang.Object[] args)
      Called when execution is ready to start bytecode interpretation for entered a particular function or script.
      void onExceptionThrown​(Context cx, java.lang.Throwable ex)
      Called when thrown exception is handled by the function or script.
      void onExit​(Context cx, boolean byThrow, java.lang.Object resultOrException)
      Called when the function or script for this frame is about to return.
      void onLineChange​(Context cx, int lineNumber)
      Called when executed code reaches new line in the source.

    • Method Detail

      • onEnter

        void onEnter​(Context cx,
             Scriptable activation,
             Scriptable thisObj,
             java.lang.Object[] args)
        Called when execution is ready to start bytecode interpretation for entered a particular function or script.
        Parameters:
        cx - current Context for this thread
        activation - the activation scope for the function or script.
        thisObj - value of the JavaScript this object
        args - the array of arguments

      • onLineChange

        void onLineChange​(Context cx,
                  int lineNumber)
        Called when executed code reaches new line in the source.
        Parameters:
        cx - current Context for this thread
        lineNumber - current line number in the script source

      • onExceptionThrown

        void onExceptionThrown​(Context cx,
                       java.lang.Throwable ex)
        Called when thrown exception is handled by the function or script.
        Parameters:
        cx - current Context for this thread
        ex - exception object

      • onExit

        void onExit​(Context cx,
            boolean byThrow,
            java.lang.Object resultOrException)
        Called when the function or script for this frame is about to return.
        Parameters:
        cx - current Context for this thread
        byThrow - if true function will leave by throwing exception, otherwise it will execute normal return
        resultOrException - function result in case of normal return or exception object if about to throw exception

      • onDebuggerStatement

        void onDebuggerStatement​(Context cx)
        Called when the function or script executes a 'debugger' statement.
        Parameters:
        cx - current Context for this thread