Back to index

lightning-sunbird  0.9+nobinonly
Public Member Functions | Public Attributes
jsdIStackFrame Interface Reference

Stack frame objects. More...

import "jsdIDebuggerService.idl";

Inheritance diagram for jsdIStackFrame:
Inheritance graph
[legend]
Collaboration diagram for jsdIStackFrame:
Collaboration graph
[legend]

List of all members.

Public Member Functions

boolean eval (in AString bytes, in string fileName, in unsigned long line, out jsdIValue result)
 Evaluate arbitrary JavaScript in this stack frame.
void invalidate ()
 Mark this instance as invalid.

Public Attributes

readonly attribute JSDContext JSDContext
 Internal use only.
readonly attribute JSDThreadState JSDThreadState
 Internal use only.
readonly attribute
JSDStackFrameInfo 
JSDStackFrameInfo
 Internal use only.
readonly attribute boolean isNative
 True if stack frame represents a native frame.
readonly attribute boolean isDebugger
 True if stack frame represents a frame created as a result of a debugger evaluation.
readonly attribute boolean isConstructing
 True if stack frame is constructing a new object.
readonly attribute jsdIStackFrame callingFrame
 Link to the caller's stack frame.
readonly attribute jsdIContext executionContext
 Executon context.
readonly attribute string functionName
 Function name executing in this stack frame.
readonly attribute jsdIScript script
 Script running in this stack frame, null for native frames.
readonly attribute unsigned long pc
 Current program counter in this stack frame.
readonly attribute unsigned long line
 Current line number (using the script's pc to line map.)
readonly attribute jsdIValue callee
 Function object running in this stack frame.
readonly attribute jsdIValue scope
 Top object in the scope chain.
readonly attribute jsdIValue thisValue
 |this| object for this stack frame.
readonly attribute boolean isValid
 |true| if this object is still valid.

Detailed Description

Stack frame objects.

These are only valid inside the jsdIExecutionHook which gave it to you. After you return from that handler the bottom frame, and any frame you found attached through it, are invalidated via the jsdIEphemeral interface. Once a jsdIStackFrame has been invalidated all method and property accesses will throw a NS_ERROR_NOT_AVAILABLE exception.

Definition at line 781 of file jsdIDebuggerService.idl.


Member Function Documentation

boolean jsdIStackFrame::eval ( in AString  bytes,
in string  fileName,
in unsigned long  line,
out jsdIValue  result 
)

Evaluate arbitrary JavaScript in this stack frame.

Parameters:
bytesScript to be evaluated.
fileNameFilename to compile this script under. This is the filename you'll see in error messages, etc.
lineStarting line number for this script. One based.
Return values:
Resultof evaluating the script.

Mark this instance as invalid.


Member Data Documentation

Function object running in this stack frame.

Definition at line 831 of file jsdIDebuggerService.idl.

Link to the caller's stack frame.

Definition at line 807 of file jsdIDebuggerService.idl.

Executon context.

Definition at line 811 of file jsdIDebuggerService.idl.

Function name executing in this stack frame.

Definition at line 815 of file jsdIDebuggerService.idl.

True if stack frame is constructing a new object.

Definition at line 802 of file jsdIDebuggerService.idl.

True if stack frame represents a frame created as a result of a debugger evaluation.

Definition at line 798 of file jsdIDebuggerService.idl.

True if stack frame represents a native frame.

Definition at line 793 of file jsdIDebuggerService.idl.

|true| if this object is still valid.

If not, many or all of the methods and/or properties of the inheritor may no longer be callable.

Definition at line 691 of file jsdIDebuggerService.idl.

Internal use only.

Definition at line 784 of file jsdIDebuggerService.idl.

Internal use only.

Definition at line 788 of file jsdIDebuggerService.idl.

Internal use only.

Definition at line 786 of file jsdIDebuggerService.idl.

readonly attribute unsigned long jsdIStackFrame::line

Current line number (using the script's pc to line map.)

Definition at line 827 of file jsdIDebuggerService.idl.

readonly attribute unsigned long jsdIStackFrame::pc

Current program counter in this stack frame.

Definition at line 823 of file jsdIDebuggerService.idl.

Top object in the scope chain.

Definition at line 835 of file jsdIDebuggerService.idl.

Script running in this stack frame, null for native frames.

Definition at line 819 of file jsdIDebuggerService.idl.

|this| object for this stack frame.

Definition at line 839 of file jsdIDebuggerService.idl.


The documentation for this interface was generated from the following file: