Home | History | Annotate | Download | only in v8
      1 /*
      2  * Copyright (C) 2009 Google Inc. All rights reserved.
      3  *
      4  * Redistribution and use in source and binary forms, with or without
      5  * modification, are permitted provided that the following conditions are
      6  * met:
      7  *
      8  *     * Redistributions of source code must retain the above copyright
      9  * notice, this list of conditions and the following disclaimer.
     10  *     * Redistributions in binary form must reproduce the above
     11  * copyright notice, this list of conditions and the following disclaimer
     12  * in the documentation and/or other materials provided with the
     13  * distribution.
     14  *     * Neither the name of Google Inc. nor the names of its
     15  * contributors may be used to endorse or promote products derived from
     16  * this software without specific prior written permission.
     17  *
     18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
     24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     29  */
     30 
     31 #ifndef V8DOMActivityLogger_h
     32 #define V8DOMActivityLogger_h
     33 
     34 #include "wtf/PassOwnPtr.h"
     35 #include "wtf/text/WTFString.h"
     36 #include <v8.h>
     37 
     38 namespace blink {
     39 
     40 class KURL;
     41 
     42 class V8DOMActivityLogger {
     43 public:
     44     virtual ~V8DOMActivityLogger() { }
     45 
     46     virtual void logGetter(const String& apiName) { }
     47     virtual void logSetter(const String& apiName, const v8::Handle<v8::Value>& newValue) { }
     48     virtual void logMethod(const String& apiName, int argc, const v8::Handle<v8::Value>* argv) { }
     49     virtual void logEvent(const String& eventName, int argc, const String* argv) { }
     50 
     51     // Associates a logger with the world identified by worldId (worlId may be 0
     52     // identifying the main world) and extension ID. Extension ID is used to
     53     // identify a logger for main world only (worldId == 0). If the world is not
     54     // a main world, an extension ID is ignored.
     55     //
     56     // A renderer process may host multiple extensions when the browser hits the
     57     // renderer process limit. In such case, we assign multiple extensions to
     58     // the same main world of a renderer process. In order to distinguish the
     59     // extensions and their activity loggers in the main world, we require an
     60     // extension ID. Otherwise, extension activities may be logged under
     61     // a wrong extension ID.
     62     static void setActivityLogger(int worldId, const String&, PassOwnPtr<V8DOMActivityLogger>);
     63     static V8DOMActivityLogger* activityLogger(int worldId, const String& extensionId);
     64     static V8DOMActivityLogger* activityLogger(int worldId, const KURL&);
     65 
     66     // Returns activity logger for current V8 context or 0.
     67     static V8DOMActivityLogger* currentActivityLogger();
     68     // Returns activity logger for current V8 context if the context belongs to
     69     // an isolated world or 0.
     70     static V8DOMActivityLogger* currentActivityLoggerIfIsolatedWorld();
     71 
     72 };
     73 
     74 } // namespace blink
     75 
     76 #endif // V8DOMActivityLogger_h
     77