// Copyright 2008, Google Inc. // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Google Inc. nor the names of its // contributors may be used to endorse or promote products derived from // this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // An interface to the V8 debugger. This is in WebKit in order to isolate // the renderer from a direct V8 dependency. #ifndef WEBKIT_GLUE_DEBUGGER_H #define WEBKIT_GLUE_DEBUGGER_H #include #include "base/basictypes.h" #include "base/message_loop.h" #include "v8/public/debug.h" void V8DebugMessageHandler(const uint16_t* message, int length, void* data); class Debugger : public base::RefCountedThreadSafe { public: class Delegate { public: virtual void DebuggerOutput(const std::wstring& data) = 0; }; // When constructed, the underlying V8 debugger is initialized and connected // to the internals of this object. The provided delegate received output // from the debugger. This output may be spontaneous (error messages, // exceptions, etc.) or the output from a command. // NOTE: the delegate will be called from another thread Debugger(Debugger::Delegate* del); virtual ~Debugger(); // Sends a command to the debugger (same as v8 command-line debugger). // Results from the command come asynchronously. // TODO(erikkay): link command output to a particular command void Command(const std::wstring& cmd); // Attach and detach from the V8 debug message handler. void Attach(); void Detach(); private: friend void V8DebugMessageHandler(const uint16_t* message, int length, void* data); // Called by the LocalDebugSession so that the delegate can called in the // appropriate thread. void OutputLater(const std::wstring& cmd); // Calls the delegate. This method is called in the delegate's thread. void Output(const std::wstring& out); Delegate* delegate_; MessageLoop* delegate_loop_; bool attached_; DISALLOW_EVIL_CONSTRUCTORS(Debugger); }; #endif // WEBKIT_GLUE_DEBUGGER_H