gecko-dev/js/jsd/jsdebug.h

294 строки
8.9 KiB
C

/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
*
* 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.
*/
/*
** Header for JavaScript Debugger for Navigator interfaces
*/
#ifndef jsdebug_h___
#define jsdebug_h___
#include "ntypes.h"
#ifndef NSPR20
#include "prmacros.h"
#else
#include "prtypes.h"
#endif
#include "jsapi.h"
NSPR_BEGIN_EXTERN_C
/***************************************************************************/
/* Opaque typdefs for handles */
typedef struct JSDContext JSDContext;
typedef struct JSDScript JSDScript;
typedef struct JSDSourceText JSDSourceText;
typedef struct JSDThreadState JSDThreadState;
typedef struct JSDStackFrameInfo JSDStackFrameInfo;
/***************************************************************************/
/* High Level calls */
PR_PUBLIC_API(JSDContext*)
JSD_DebuggerOn(void);
PR_PUBLIC_API(void)
JSD_DebuggerOff(JSDContext* jsdc);
PR_PUBLIC_API(PRUintn)
JSD_GetMajorVersion(void);
PR_PUBLIC_API(PRUintn)
JSD_GetMinorVersion(void);
PR_PUBLIC_API(JSContext*)
JSD_GetDefaultJSContext(JSDContext* jsdc);
/* callback stuff for calls in EXE to be accessed by this code in a DLL */
typedef void
(*JSD_SetContextProc)(JSDContext* jsdc, void* user);
typedef struct
{
PRUintn size; /* size of this struct (init before use)*/
JSD_SetContextProc setContext;
} JSD_UserCallbacks;
PR_PUBLIC_API(void)
JSD_SetUserCallbacks(JSTaskState* jstaskstate, JSD_UserCallbacks* callbacks, void* user);
/***************************************************************************/
/* Script functions */
PR_PUBLIC_API(void)
JSD_LockScriptSubsystem(JSDContext* jsdc);
PR_PUBLIC_API(void)
JSD_UnlockScriptSubsystem(JSDContext* jsdc);
PR_PUBLIC_API(JSDScript*)
JSD_IterateScripts(JSDContext* jsdc, JSDScript **iterp);
PR_PUBLIC_API(const char*)
JSD_GetScriptFilename(JSDContext* jsdc, JSDScript *jsdscript);
PR_PUBLIC_API(const char*)
JSD_GetScriptFunctionName(JSDContext* jsdc, JSDScript *jsdscript);
PR_PUBLIC_API(PRUintn)
JSD_GetScriptBaseLineNumber(JSDContext* jsdc, JSDScript *jsdscript);
PR_PUBLIC_API(PRUintn)
JSD_GetScriptLineExtent(JSDContext* jsdc, JSDScript *jsdscript);
typedef void
(*JSD_ScriptHookProc)( JSDContext* jsdc,
JSDScript* jsdscript,
JSBool creating,
void* callerdata );
PR_PUBLIC_API(JSD_ScriptHookProc)
JSD_SetScriptHook(JSDContext* jsdc, JSD_ScriptHookProc hook, void* callerdata);
PR_PUBLIC_API(JSD_ScriptHookProc)
JSD_GetScriptHook(JSDContext* jsdc);
PR_PUBLIC_API(prword_t)
JSD_GetClosestPC(JSDContext* jsdc, JSDScript* jsdscript, PRUintn line);
PR_PUBLIC_API(PRUintn)
JSD_GetClosestLine(JSDContext* jsdc, JSDScript* jsdscript, prword_t pc);
/***************************************************************************/
/* Source Text functions */
/* these coorespond to netscape.jsdebug.SourceTextItem.java values -
* change in both places if anywhere
*/
typedef enum
{
JSD_SOURCE_INITED,
JSD_SOURCE_PARTIAL,
JSD_SOURCE_COMPLETED,
JSD_SOURCE_ABORTED,
JSD_SOURCE_FAILED,
JSD_SOURCE_CLEARED
} JSDSourceStatus;
PR_PUBLIC_API(void)
JSD_LockSourceTextSubsystem(JSDContext* jsdc);
PR_PUBLIC_API(void)
JSD_UnlockSourceTextSubsystem(JSDContext* jsdc);
PR_PUBLIC_API(JSDSourceText*)
JSD_IterateSources(JSDContext* jsdc, JSDSourceText **iterp);
PR_PUBLIC_API(JSDSourceText*)
JSD_FindSourceForURL(JSDContext* jsdc, const char* url);
PR_PUBLIC_API(const char*)
JSD_GetSourceURL(JSDContext* jsdc, JSDSourceText* jsdsrc);
PR_PUBLIC_API(JSBool)
JSD_GetSourceText(JSDContext* jsdc, JSDSourceText* jsdsrc,
const char** ppBuf, int* pLen);
PR_PUBLIC_API(void)
JSD_ClearSourceText(JSDContext* jsdc, JSDSourceText* jsdsrc);
PR_PUBLIC_API(JSDSourceStatus)
JSD_GetSourceStatus(JSDContext* jsdc, JSDSourceText* jsdsrc);
PR_PUBLIC_API(JSBool)
JSD_IsSourceDirty(JSDContext* jsdc, JSDSourceText* jsdsrc);
PR_PUBLIC_API(void)
JSD_SetSourceDirty(JSDContext* jsdc, JSDSourceText* jsdsrc, JSBool dirty);
PR_PUBLIC_API(PRUintn)
JSD_GetSourceAlterCount(JSDContext* jsdc, JSDSourceText* jsdsrc);
PR_PUBLIC_API(PRUintn)
JSD_IncrementSourceAlterCount(JSDContext* jsdc, JSDSourceText* jsdsrc);
/* functions for adding source items */
PR_PUBLIC_API(JSDSourceText*)
JSD_NewSourceText(JSDContext* jsdc, const char* url);
PR_PUBLIC_API(JSDSourceText*)
JSD_AppendSourceText(JSDContext* jsdc,
JSDSourceText* jsdsrc,
const char* text, /* *not* zero terminated */
size_t length,
JSDSourceStatus status);
/***************************************************************************/
/* Execution/Interrupt Hook functions */
#define JSD_HOOK_INTERRUPTED 0
#define JSD_HOOK_BREAKPOINT 1
#define JSD_HOOK_DEBUG_REQUESTED 2
#define JSD_HOOK_RETURN_HOOK_ERROR 0
#define JSD_HOOK_RETURN_CONTINUE 1
#define JSD_HOOK_RETURN_ABORT 2
#define JSD_HOOK_RETURN_RET_WITH_VAL 3 /* not yet supported */
typedef PRUintn
(*JSD_ExecutionHookProc)( JSDContext* jsdc,
JSDThreadState* jsdthreadstate,
PRUintn type,
void* callerdata );
PR_PUBLIC_API(JSBool)
JSD_SetExecutionHook(JSDContext* jsdc,
JSDScript* jsdscript,
prword_t pc,
JSD_ExecutionHookProc hook,
void* callerdata);
PR_PUBLIC_API(JSBool)
JSD_ClearExecutionHook(JSDContext* jsdc,
JSDScript* jsdscript,
prword_t pc);
PR_PUBLIC_API(JSBool)
JSD_ClearAllExecutionHooksForScript(JSDContext* jsdc, JSDScript* jsdscript);
PR_PUBLIC_API(JSBool)
JSD_ClearAllExecutionHooks(JSDContext* jsdc);
PR_PUBLIC_API(JSBool)
JSD_SetInterruptHook(JSDContext* jsdc,
JSD_ExecutionHookProc hook,
void* callerdata);
PR_PUBLIC_API(JSBool)
JSD_ClearInterruptHook(JSDContext* jsdc);
PR_PUBLIC_API(JSBool)
JSD_SetDebugBreakHook(JSDContext* jsdc,
JSD_ExecutionHookProc hook,
void* callerdata);
PR_PUBLIC_API(JSBool)
JSD_ClearDebugBreakHook(JSDContext* jsdc);
/***************************************************************************/
/* Stack Frame functions */
PR_PUBLIC_API(PRUintn)
JSD_GetCountOfStackFrames(JSDContext* jsdc, JSDThreadState* jsdthreadstate);
PR_PUBLIC_API(JSDStackFrameInfo*)
JSD_GetStackFrame(JSDContext* jsdc, JSDThreadState* jsdthreadstate);
PR_PUBLIC_API(JSDStackFrameInfo*)
JSD_GetCallingStackFrame(JSDContext* jsdc,
JSDThreadState* jsdthreadstate,
JSDStackFrameInfo* jsdframe);
PR_PUBLIC_API(JSDScript*)
JSD_GetScriptForStackFrame(JSDContext* jsdc,
JSDThreadState* jsdthreadstate,
JSDStackFrameInfo* jsdframe);
PR_PUBLIC_API(prword_t)
JSD_GetPCForStackFrame(JSDContext* jsdc,
JSDThreadState* jsdthreadstate,
JSDStackFrameInfo* jsdframe);
PR_PUBLIC_API(JSBool)
JSD_EvaluateScriptInStackFrame(JSDContext* jsdc,
JSDThreadState* jsdthreadstate,
JSDStackFrameInfo* jsdframe,
const char *bytes, PRUintn length,
const char *filename, PRUintn lineno, jsval *rval);
PR_PUBLIC_API(JSString*)
JSD_ValToStringInStackFrame(JSDContext* jsdc,
JSDThreadState* jsdthreadstate,
JSDStackFrameInfo* jsdframe,
jsval val);
/***************************************************************************/
/* Error Reporter functions */
#define JSD_ERROR_REPORTER_PASS_ALONG 0
#define JSD_ERROR_REPORTER_RETURN 1
#define JSD_ERROR_REPORTER_DEBUG 2
typedef PRUintn
(*JSD_ErrorReporter)( JSDContext* jsdc,
JSContext* cx,
const char* message,
JSErrorReport* report,
void* callerdata );
PR_PUBLIC_API(JSD_ErrorReporter)
JSD_SetErrorReporter( JSDContext* jsdc, JSD_ErrorReporter reporter, void* callerdata);
NSPR_END_EXTERN_C
#endif /* jsdebug_h___ */