Home >> All >> netscape >> [ jsdebug Javadoc ]

• netscape.jsdebug: Javadoc index of package netscape.jsdebug.


Package Samples:

• netscape.jsdebug

Classes:

• DebugController: This is the master control panel for observing events in the VM. Each method setXHook() must be passed an object that extends the class XHook. When an event of the specified type occurs, a well-known method on XHook will be called (see the various XHook classes for details). The method call takes place on the same thread that triggered the event in the first place, so that any monitors held by the thread which triggered the hook will still be owned in the hook method. This class is meant to be a singleton and has a private constructor. Call the static getDebugController() to get this object. Note ...
• JSStackFrameInfo: This interface provides access to the execution stack of a thread. It has several subclasses to distinguish between different kinds of stack frames: these currently include activations of Java methods or JavaScript functions. It is possible that synchronize blocks and try blocks deserve their own stack frames - to allow for later extensions a debugger should skip over stack frames it doesn't understand. Note that this appears very Java-specific. However, multiple threads and exceptions are relevant to JavaScript as well because of its interoperation with Java.
• StackFrameInfo: This interface provides access to the execution stack of a thread. It has several subclasses to distinguish between different kinds of stack frames: these currently include activations of Java methods or JavaScript functions. It is possible that synchronize blocks and try blocks deserve their own stack frames - to allow for later extensions a debugger should skip over stack frames it doesn't understand. Note that this appears very Java-specific. However, multiple threads and exceptions are relevant to JavaScript as well because of its interoperation with Java.
• SourceTextItem: This class is used to represent a file or url which contains JavaScript source text. The actual JavaScript source may be intermixed with other text (as in an html file) or raw. The debugger uses this interface to access the source. The file of the actual source need not physially exist anywhere; i.e. the underlying engine might synthesize it as needed. The url of this class is immutable -- it represents a key in collections of these objects
• JSSourceTextProvider: This class provides access to SourceText items. This class is meant to be a singleton and has a private constructor. Call the static getSourceTextProvider() to get this object. Note that all functions use netscape.security.PrivilegeManager to verify that the caller has the "Debugger" privilege. The exception netscape.security.ForbiddenTargetException will be throw if this is not enabled.
• Script: This instances of this class represent the JavaScript string object. This class is intended to only be constructed by the underlying native code. The DebugController will construct an instance of this class when scripts are created and that instance will always be used to reference the underlying script throughout the lifetime of that script.
• SourceLocation: An implementation of the SourceLocation interface is used to represent a location in a source file. Java classfiles only make source locations available at the line-by-line granularity, but other languages may include finer-grain information. At this time only line number information is included.
• ThreadStateBase: When a hook is hit, the debugger records the state of the thread before the hook in a ThreadState object. This object is then passed to any hook methods that are called, and can be used to change the state of the thread when it resumes from the hook.
• PC: The PC class is an opaque representation of a program counter. It may have different implementations for interpreted Java methods, methods compiled by the JIT, JavaScript methods, etc.
• Hook: An instance of this class is returned for each hook set by the debugger as a handle for removing the hook later.
• InstructionHook: InstructionHook must be subclassed to respond to hooks at a particular program instruction.
• DebugBreakHook: DebugBreakHook must be subclassed to respond when a debug break is requested
• ScriptHook: ScriptHook must be subclassed to respond to loading and unloading of scripts
• SourceTextProvider: Abstract class to represent entity capable of providing access to source text
• JSThreadState: This is the JavaScript specific implementation of the thread state
• InterruptHook: InterruptHook must be subclassed to respond when interrupts occur
• JSErrorReporter: This is a special kind of hook to respond to JavaScript errors
• JSPC: This subclass of PC provides JavaScript-specific information.
• InvalidInfoException: Exception to indicate bad thread state etc...
• JSSourceLocation: JAvaScript specific SourceLocation

Home | Contact Us | Privacy Policy | Terms of Service