Package org.mozilla.javascript.tools.debugger

## Class Main

- java.lang.Object
- - org.mozilla.javascript.tools.debugger.Main

-     public class Main
      extends java.lang.Object

  Rhino script debugger main class. This class links together a debugger object (`Dim`) and a debugger GUI object (`SwingGui`).

- - ### Constructor Summary

    Constructors
    Constructor | Description
    --- | ---
    `Main​(java.lang.String title)` | Creates a new Main.

  - ### Method Summary

    All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `void` | `attachTo​(ContextFactory factory)` | Attaches the debugger to the given `ContextFactory`.
    `void` | `clearAllBreakpoints()` | Removes all breakpoints.
    `void` | `contextCreated​(Context cx)` | Deprecated. The method is only present for compatibility and should not be called.
    `void` | `contextEntered​(Context cx)` | Deprecated. The method is only present for compatibility and should not be called.
    `void` | `contextExited​(Context cx)` | Deprecated. The method is only present for compatibility and should not be called.
    `void` | `contextReleased​(Context cx)` | Deprecated. The method is only present for compatibility and should not be called.
    `void` | `detach()` | Detaches from the current `ContextFactory`.
    `void` | `dispose()` | Frees any resources held by the debugger.
    `void` | `doBreak()` | Breaks execution of the script.
    `javax.swing.JFrame` | `getDebugFrame()` | Returns the debugger window `JFrame`.
    `java.io.PrintStream` | `getErr()` | Returns a `PrintStream` for stderr in the Debugger's internal Console window.
    `java.io.InputStream` | `getIn()` | Returns an `InputStream` for stdin from the debugger's internal Console window.
    `java.io.PrintStream` | `getOut()` | Returns a `PrintStream` for stdout to the debugger's internal Console window.
    `void` | `go()` | Resumes execution of the script.
    `boolean` | `isVisible()` | Returns whether the debugger GUI frame is visible.
    `static void` | `main​(java.lang.String[] args)` | Main entry point.
    `static Main` | `mainEmbedded​(java.lang.String title)` | Entry point for embedded applications.
    `static Main` | `mainEmbedded​(ContextFactory factory, Scriptable scope, java.lang.String title)` | Entry point for embedded applications.
    `static Main` | `mainEmbedded​(ContextFactory factory, ScopeProvider scopeProvider, java.lang.String title)` | Entry point for embedded applications.
    `void` | `pack()` | Packs the debugger GUI frame.
    `void` | `setBreakOnEnter​(boolean value)` | Sets whether execution should break when a function is entered.
    `void` | `setBreakOnExceptions​(boolean value)` | Sets whether execution should break when a script exception is thrown.
    `void` | `setBreakOnReturn​(boolean value)` | Sets whether execution should break when a function is left.
    `void` | `setExitAction​(java.lang.Runnable r)` | Assign a Runnable object that will be invoked when the user selects "Exit..." or closes the Debugger main window.
    `void` | `setOptimizationLevel​(int level)` | Deprecated. The method does nothing and is only present for compatibility.
    `void` | `setScope​(Scriptable scope)` | Sets the scope to be used for script evaluation.
    `void` | `setScopeProvider​(ScopeProvider p)` | Sets the `ScopeProvider` that provides a scope to be used for script evaluation.
    `void` | `setSize​(int w, int h)` | Sets the debugger GUI frame dimensions.
    `void` | `setSize​(java.awt.Dimension dimension)` | Deprecated. Use `setSize(int, int)` instead.
    `void` | `setSourceProvider​(SourceProvider sourceProvider)` | Sets the `SourceProvider` that provides the source to be displayed for script evaluation.
    `void` | `setVisible​(boolean flag)` | Sets the visibility of the debugger GUI frame.

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Constructor Detail

    - #### Main

          public Main​(java.lang.String title)

      Creates a new Main.

  - ### Method Detail

    - #### getDebugFrame

          public javax.swing.JFrame getDebugFrame()

      Returns the debugger window `JFrame`.

    - #### doBreak

          public void doBreak()

      Breaks execution of the script.

    - #### setBreakOnExceptions

          public void setBreakOnExceptions​(boolean value)

      Sets whether execution should break when a script exception is thrown.

    - #### setBreakOnEnter

          public void setBreakOnEnter​(boolean value)

      Sets whether execution should break when a function is entered.

    - #### setBreakOnReturn

          public void setBreakOnReturn​(boolean value)

      Sets whether execution should break when a function is left.

    - #### clearAllBreakpoints

          public void clearAllBreakpoints()

      Removes all breakpoints.

    - #### go

          public void go()

      Resumes execution of the script.

    - #### setScope

          public void setScope​(Scriptable scope)

      Sets the scope to be used for script evaluation.

    - #### setScopeProvider

          public void setScopeProvider​(ScopeProvider p)

      Sets the `ScopeProvider` that provides a scope to be used for script evaluation.

    - #### setSourceProvider

          public void setSourceProvider​(SourceProvider sourceProvider)

      Sets the `SourceProvider` that provides the source to be displayed for script evaluation.

    - #### setExitAction

          public void setExitAction​(java.lang.Runnable r)

      Assign a Runnable object that will be invoked when the user selects "Exit..." or closes the Debugger main window.

    - #### getIn

          public java.io.InputStream getIn()

      Returns an `InputStream` for stdin from the debugger's internal Console window.

    - #### getOut

          public java.io.PrintStream getOut()

      Returns a `PrintStream` for stdout to the debugger's internal Console window.

    - #### getErr

          public java.io.PrintStream getErr()

      Returns a `PrintStream` for stderr in the Debugger's internal Console window.

    - #### pack

          public void pack()

      Packs the debugger GUI frame.

    - #### setSize

          public void setSize​(int w,
                              int h)

      Sets the debugger GUI frame dimensions.

    - #### setVisible

          public void setVisible​(boolean flag)

      Sets the visibility of the debugger GUI frame.

    - #### isVisible

          public boolean isVisible()

      Returns whether the debugger GUI frame is visible.

    - #### dispose

          public void dispose()

      Frees any resources held by the debugger.

    - #### attachTo

          public void attachTo​(ContextFactory factory)

      Attaches the debugger to the given `ContextFactory`.

    - #### detach

          public void detach()

      Detaches from the current `ContextFactory`.

    - #### main

          public static void main​(java.lang.String[] args)

      Main entry point. Creates a debugger attached to a Rhino `Main` shell session.

    - #### mainEmbedded

          public static Main mainEmbedded​(java.lang.String title)

      Entry point for embedded applications. This method attaches to the global `ContextFactory` with a scope of a newly created `Global` object. No I/O redirection is performed as with `main(String[])`.

    - #### mainEmbedded

          public static Main mainEmbedded​(ContextFactory factory,
                                          Scriptable scope,
                                          java.lang.String title)

      Entry point for embedded applications. This method attaches to the given `ContextFactory` with the given scope. No I/O redirection is performed as with `main(String[])`.

    - #### mainEmbedded

          public static Main mainEmbedded​(ContextFactory factory,
                                          ScopeProvider scopeProvider,
                                          java.lang.String title)

      Entry point for embedded applications. This method attaches to the given `ContextFactory` with the given scope. No I/O redirection is performed as with `main(String[])`.

    - #### setSize

          @Deprecated
          public void setSize​(java.awt.Dimension dimension)

      Deprecated.
      Use `setSize(int, int)` instead.

    - #### setOptimizationLevel

          @Deprecated
          public void setOptimizationLevel​(int level)

      Deprecated.
      The method does nothing and is only present for compatibility.

    - #### contextEntered

          @Deprecated
          public void contextEntered​(Context cx)

      Deprecated.
      The method is only present for compatibility and should not be called.

    - #### contextExited

          @Deprecated
          public void contextExited​(Context cx)

      Deprecated.
      The method is only present for compatibility and should not be called.

    - #### contextCreated

          @Deprecated
          public void contextCreated​(Context cx)

      Deprecated.
      The method is only present for compatibility and should not be called.

    - #### contextReleased

          @Deprecated
          public void contextReleased​(Context cx)

      Deprecated.
      The method is only present for compatibility and should not be called.