mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-30 00:01:50 +00:00
845c56005f
Including: Preliminary work on internationalizing error messages Preliminary work on exposing runtime errors as catchable exceptions ECMA-proposed throw and try/catch/finally, with multiple catch clauses and catchguards ECMA-proposed in/instanceof operators IEEE-conformant number to string conversion Fixes and other good stuff.
229 lines
7.2 KiB
C
229 lines
7.2 KiB
C
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
|
*
|
|
* The contents of this file are subject to the Netscape Public License
|
|
* Version 1.0 (the "NPL"); you may not use this file except in
|
|
* compliance with the NPL. You may obtain a copy of the NPL at
|
|
* http://www.mozilla.org/NPL/
|
|
*
|
|
* Software distributed under the NPL is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
|
|
* for the specific language governing rights and limitations under the
|
|
* NPL.
|
|
*
|
|
* The Initial Developer of this code under the NPL is Netscape
|
|
* Communications Corporation. Portions created by Netscape are
|
|
* Copyright (C) 1998 Netscape Communications Corporation. All Rights
|
|
* Reserved.
|
|
*/
|
|
|
|
#ifndef jsdbgapi_h___
|
|
#define jsdbgapi_h___
|
|
/*
|
|
* JS debugger API.
|
|
*/
|
|
#include "jsapi.h"
|
|
#include "jsopcode.h"
|
|
#include "jsprvtd.h"
|
|
|
|
PR_BEGIN_EXTERN_C
|
|
|
|
extern void
|
|
js_PatchOpcode(JSContext *cx, JSScript *script, jsbytecode *pc, JSOp op);
|
|
|
|
extern JS_PUBLIC_API(JSBool)
|
|
JS_SetTrap(JSContext *cx, JSScript *script, jsbytecode *pc,
|
|
JSTrapHandler handler, void *closure);
|
|
|
|
extern JS_PUBLIC_API(JSOp)
|
|
JS_GetTrapOpcode(JSContext *cx, JSScript *script, jsbytecode *pc);
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_ClearTrap(JSContext *cx, JSScript *script, jsbytecode *pc,
|
|
JSTrapHandler *handlerp, void **closurep);
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_ClearScriptTraps(JSContext *cx, JSScript *script);
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_ClearAllTraps(JSContext *cx);
|
|
|
|
extern JS_PUBLIC_API(JSTrapStatus)
|
|
JS_HandleTrap(JSContext *cx, JSScript *script, jsbytecode *pc, jsval *rval);
|
|
|
|
extern JS_PUBLIC_API(JSBool)
|
|
JS_SetInterrupt(JSRuntime *rt, JSTrapHandler handler, void *closure);
|
|
|
|
extern JS_PUBLIC_API(JSBool)
|
|
JS_ClearInterrupt(JSRuntime *rt, JSTrapHandler *handlerp, void **closurep);
|
|
|
|
/************************************************************************/
|
|
|
|
typedef JSBool
|
|
(*JSWatchPointHandler)(JSContext *cx, JSObject *obj, jsval id,
|
|
jsval old, jsval *newp, void *closure);
|
|
|
|
extern JS_PUBLIC_API(JSBool)
|
|
JS_SetWatchPoint(JSContext *cx, JSObject *obj, jsval id,
|
|
JSWatchPointHandler handler, void *closure);
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_ClearWatchPoint(JSContext *cx, JSObject *obj, jsval id,
|
|
JSWatchPointHandler *handlerp, void **closurep);
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_ClearWatchPointsForObject(JSContext *cx, JSObject *obj);
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_ClearAllWatchPoints(JSContext *cx);
|
|
|
|
#ifdef JS_HAS_OBJ_WATCHPOINT
|
|
/*
|
|
* Hide these non-API function prototypes by testing whether the internal
|
|
* header file "jsconfig.h" has been included.
|
|
*/
|
|
extern JSScopeProperty *
|
|
js_FindWatchPoint(JSRuntime *rt, JSObject *obj, jsval userid);
|
|
|
|
extern JSBool PR_CALLBACK
|
|
js_watch_set(JSContext *cx, JSObject *obj, jsval id, jsval *vp);
|
|
#endif
|
|
|
|
/************************************************************************/
|
|
|
|
extern JS_PUBLIC_API(uintN)
|
|
JS_PCToLineNumber(JSContext *cx, JSScript *script, jsbytecode *pc);
|
|
|
|
extern JS_PUBLIC_API(jsbytecode *)
|
|
JS_LineNumberToPC(JSContext *cx, JSScript *script, uintN lineno);
|
|
|
|
extern JS_PUBLIC_API(JSScript *)
|
|
JS_GetFunctionScript(JSContext *cx, JSFunction *fun);
|
|
|
|
extern JS_PUBLIC_API(JSPrincipals *)
|
|
JS_GetScriptPrincipals(JSContext *cx, JSScript *script);
|
|
|
|
/*
|
|
* Stack Frame Iterator
|
|
*
|
|
* Used to iterate through the JS stack frames to extract
|
|
* information from the frames.
|
|
*/
|
|
|
|
extern JS_PUBLIC_API(JSStackFrame *)
|
|
JS_FrameIterator(JSContext *cx, JSStackFrame **iteratorp);
|
|
|
|
extern JS_PUBLIC_API(JSScript *)
|
|
JS_GetFrameScript(JSContext *cx, JSStackFrame *fp);
|
|
|
|
extern JS_PUBLIC_API(jsbytecode *)
|
|
JS_GetFramePC(JSContext *cx, JSStackFrame *fp);
|
|
|
|
extern JS_PUBLIC_API(JSBool)
|
|
JS_IsNativeFrame(JSContext *cx, JSStackFrame *fp);
|
|
|
|
extern JS_PUBLIC_API(void *)
|
|
JS_GetFrameAnnotation(JSContext *cx, JSStackFrame *fp);
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_SetFrameAnnotation(JSContext *cx, JSStackFrame *fp, void *annotation);
|
|
|
|
extern JS_PUBLIC_API(void *)
|
|
JS_GetFramePrincipalArray(JSContext *cx, JSStackFrame *fp);
|
|
|
|
/* this is deprecated, use JS_GetFrameScopeChain instead */
|
|
extern JS_PUBLIC_API(JSObject *)
|
|
JS_GetFrameObject(JSContext *cx, JSStackFrame *fp);
|
|
|
|
extern JS_PUBLIC_API(JSObject *)
|
|
JS_GetFrameScopeChain(JSContext *cx, JSStackFrame *fp);
|
|
|
|
extern JS_PUBLIC_API(JSObject *)
|
|
JS_GetFrameCallObject(JSContext *cx, JSStackFrame *fp);
|
|
|
|
extern JS_PUBLIC_API(JSObject *)
|
|
JS_GetFrameThis(JSContext *cx, JSStackFrame *fp);
|
|
|
|
extern JS_PUBLIC_API(JSFunction *)
|
|
JS_GetFrameFunction(JSContext *cx, JSStackFrame *fp);
|
|
|
|
/************************************************************************/
|
|
|
|
extern JS_PUBLIC_API(const char *)
|
|
JS_GetScriptFilename(JSContext *cx, JSScript *script);
|
|
|
|
extern JS_PUBLIC_API(uintN)
|
|
JS_GetScriptBaseLineNumber(JSContext *cx, JSScript *script);
|
|
|
|
extern JS_PUBLIC_API(uintN)
|
|
JS_GetScriptLineExtent(JSContext *cx, JSScript *script);
|
|
|
|
/************************************************************************/
|
|
|
|
/*
|
|
* Hook setters for script creation and destruction, see jsprvtd.h for the
|
|
* typedefs. These macros provide binary compatibility and newer, shorter
|
|
* synonyms.
|
|
*/
|
|
#define JS_SetNewScriptHook JS_SetNewScriptHookProc
|
|
#define JS_SetDestroyScriptHook JS_SetDestroyScriptHookProc
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_SetNewScriptHook(JSRuntime *rt, JSNewScriptHook hook, void *callerdata);
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_SetDestroyScriptHook(JSRuntime *rt, JSDestroyScriptHook hook,
|
|
void *callerdata);
|
|
|
|
/************************************************************************/
|
|
|
|
extern JS_PUBLIC_API(JSBool)
|
|
JS_EvaluateInStackFrame(JSContext *cx, JSStackFrame *fp,
|
|
const char *bytes, uintN length,
|
|
const char *filename, uintN lineno,
|
|
jsval *rval);
|
|
|
|
/************************************************************************/
|
|
|
|
typedef struct JSPropertyDesc {
|
|
jsval id; /* primary id, a string or int */
|
|
jsval value; /* property value */
|
|
uint8 flags; /* flags, see below */
|
|
uint8 spare; /* unused */
|
|
uint16 slot; /* argument/variable slot */
|
|
jsval alias; /* alias id if JSPD_ALIAS flag */
|
|
} JSPropertyDesc;
|
|
|
|
#define JSPD_ENUMERATE 0x01 /* visible to for/in loop */
|
|
#define JSPD_READONLY 0x02 /* assignment is error */
|
|
#define JSPD_PERMANENT 0x04 /* property cannot be deleted */
|
|
#define JSPD_ALIAS 0x08 /* property has an alias id */
|
|
#define JSPD_ARGUMENT 0x10 /* argument to function */
|
|
#define JSPD_VARIABLE 0x20 /* local variable in function */
|
|
|
|
typedef struct JSPropertyDescArray {
|
|
uint32 length; /* number of elements in array */
|
|
JSPropertyDesc *array; /* alloc'd by Get, freed by Put */
|
|
} JSPropertyDescArray;
|
|
|
|
extern JS_PUBLIC_API(JSScopeProperty *)
|
|
JS_PropertyIterator(JSObject *obj, JSScopeProperty **iteratorp);
|
|
|
|
extern JS_PUBLIC_API(JSBool)
|
|
JS_GetPropertyDesc(JSContext *cx, JSObject *obj, JSScopeProperty *sprop,
|
|
JSPropertyDesc *pd);
|
|
|
|
extern JS_PUBLIC_API(JSBool)
|
|
JS_GetPropertyDescArray(JSContext *cx, JSObject *obj, JSPropertyDescArray *pda);
|
|
|
|
extern JS_PUBLIC_API(void)
|
|
JS_PutPropertyDescArray(JSContext *cx, JSPropertyDescArray *pda);
|
|
|
|
/************************************************************************/
|
|
|
|
extern JS_PUBLIC_API(JSBool)
|
|
JS_SetDebuggerHandler(JSRuntime *rt, JSTrapHandler handler, void *closure);
|
|
|
|
PR_END_EXTERN_C
|
|
|
|
#endif /* jsdbgapi_h___ */
|