include/v8-debug.h
説明を見る。
00001 // Copyright 2008 the V8 project authors. All rights reserved. 00002 // Redistribution and use in source and binary forms, with or without 00003 // modification, are permitted provided that the following conditions are 00004 // met: 00005 // 00006 // * Redistributions of source code must retain the above copyright 00007 // notice, this list of conditions and the following disclaimer. 00008 // * Redistributions in binary form must reproduce the above 00009 // copyright notice, this list of conditions and the following 00010 // disclaimer in the documentation and/or other materials provided 00011 // with the distribution. 00012 // * Neither the name of Google Inc. nor the names of its 00013 // contributors may be used to endorse or promote products derived 00014 // from this software without specific prior written permission. 00015 // 00016 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 00017 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 00018 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 00019 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 00020 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 00021 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 00022 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 00023 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 00024 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 00025 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 00026 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00027 00028 #ifndef V8_DEBUG_H_ 00029 #define V8_DEBUG_H_ 00030 00031 #include "v8.h" 00032 00033 #ifdef _WIN32 00034 typedef int int32_t; 00035 typedef unsigned int uint32_t; 00036 typedef unsigned short uint16_t; // NOLINT 00037 typedef long long int64_t; // NOLINT 00038 00039 // Setup for Windows DLL export/import. See v8.h in this directory for 00040 // information on how to build/use V8 as a DLL. 00041 #if defined(BUILDING_V8_SHARED) && defined(USING_V8_SHARED) 00042 #error both BUILDING_V8_SHARED and USING_V8_SHARED are set - please check the\ 00043 build configuration to ensure that at most one of these is set 00044 #endif 00045 00046 #ifdef BUILDING_V8_SHARED 00047 #define EXPORT __declspec(dllexport) 00048 #elif USING_V8_SHARED 00049 #define EXPORT __declspec(dllimport) 00050 #else 00051 #define EXPORT 00052 #endif 00053 00054 #else // _WIN32 00055 00056 // Setup for Linux shared library export. See v8.h in this directory for 00057 // information on how to build/use V8 as shared library. 00058 #if defined(__GNUC__) && (__GNUC__ >= 4) 00059 #define EXPORT __attribute__ ((visibility("default"))) 00060 #else // defined(__GNUC__) && (__GNUC__ >= 4) 00061 #define EXPORT 00062 #endif // defined(__GNUC__) && (__GNUC__ >= 4) 00063 00064 #endif // _WIN32 00065 00066 00070 namespace v8 { 00071 00072 // Debug events which can occur in the V8 JavaScript engine. 00073 enum DebugEvent { 00074 Break = 1, 00075 Exception = 2, 00076 NewFunction = 3, 00077 BeforeCompile = 4, 00078 AfterCompile = 5 00079 }; 00080 00081 00091 typedef void (*DebugEventCallback)(DebugEvent event, 00092 Handle<Object> exec_state, 00093 Handle<Object> event_data, 00094 Handle<Value> data); 00095 00096 00105 typedef void (*DebugMessageHandler)(const uint16_t* message, int length, 00106 void* data); 00107 00108 00109 class EXPORT Debug { 00110 public: 00111 // Add a C debug event listener. 00112 static bool AddDebugEventListener(DebugEventCallback that, 00113 Handle<Value> data = Handle<Value>()); 00114 00115 // Add a JavaScript debug event listener. 00116 static bool AddDebugEventListener(v8::Handle<v8::Function> that, 00117 Handle<Value> data = Handle<Value>()); 00118 00119 // Remove a C debug event listener. 00120 static void RemoveDebugEventListener(DebugEventCallback that); 00121 00122 // Remove a JavaScript debug event listener. 00123 static void RemoveDebugEventListener(v8::Handle<v8::Function> that); 00124 00125 // Generate a stack dump. 00126 static void StackDump(); 00127 00128 // Break execution of JavaScript. 00129 static void DebugBreak(); 00130 00131 // Message based interface. The message protocol is JSON. 00132 static void SetMessageHandler(DebugMessageHandler handler, void* data = NULL); 00133 static void SendCommand(const uint16_t* command, int length); 00134 }; 00135 00136 00137 } // namespace v8 00138 00139 00140 #undef EXPORT 00141 00142 00143 #endif // V8_DEBUG_H_
