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 WebScriptController_h 32 #define WebScriptController_h 33 34 #include "WebCommon.h" 35 36 namespace v8 { 37 class Extension; 38 } 39 40 namespace WebKit { 41 42 class WebString; 43 44 class WebScriptController { 45 public: 46 // Registers a v8 extension to be available on webpages. The three forms 47 // offer various restrictions on what types of contexts the extension is 48 // loaded into. If a scheme is provided, only pages whose URL has the given 49 // scheme will match. If extensionGroup is provided, the extension will only 50 // be loaded into scripts run via WebFrame::ExecuteInNewWorld with the 51 // matching group. 52 // Will only affect v8 contexts initialized after this call. Takes ownership 53 // of the v8::Extension object passed. 54 WEBKIT_API static void registerExtension(v8::Extension*); 55 56 // Enables special settings which are only applicable if V8 is executed 57 // in the single thread which must be the main thread. 58 // FIXME: make a try to dynamically detect when this condition is broken 59 // and automatically switch off single thread mode. 60 WEBKIT_API static void enableV8SingleThreadMode(); 61 62 // Process any pending JavaScript console messages. 63 WEBKIT_API static void flushConsoleMessages(); 64 65 private: 66 WebScriptController(); 67 }; 68 69 } // namespace WebKit 70 71 #endif 72