| /* |
| * Copyright (C) 2008, 2009 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. |
| */ |
| |
| #ifndef ScriptController_h |
| #define ScriptController_h |
| |
| #include "bindings/core/v8/WindowProxyManager.h" |
| #include "core/CoreExport.h" |
| #include "core/dom/ExecutionContext.h" |
| #include "platform/bindings/SharedPersistent.h" |
| #include "platform/heap/Handle.h" |
| #include "platform/loader/fetch/AccessControlStatus.h" |
| #include "platform/loader/fetch/CrossOriginAccessControl.h" |
| #include "platform/wtf/HashMap.h" |
| #include "platform/wtf/Noncopyable.h" |
| #include "platform/wtf/Vector.h" |
| #include "platform/wtf/text/TextPosition.h" |
| #include "v8/include/v8.h" |
| |
| namespace blink { |
| |
| class DOMWrapperWorld; |
| class Element; |
| class KURL; |
| class LocalFrame; |
| class ScriptSourceCode; |
| class SecurityOrigin; |
| |
| typedef WTF::Vector<v8::Extension*> V8Extensions; |
| |
| // This class exposes methods to run script in a frame (in the main world and |
| // in isolated worlds). An instance can be obtained by using |
| // LocalFrame::GetScriptController(). |
| class CORE_EXPORT ScriptController final |
| : public GarbageCollected<ScriptController> { |
| WTF_MAKE_NONCOPYABLE(ScriptController); |
| |
| public: |
| enum ExecuteScriptPolicy { |
| kExecuteScriptWhenScriptsDisabled, |
| kDoNotExecuteScriptWhenScriptsDisabled |
| }; |
| |
| static ScriptController* Create( |
| LocalFrame& frame, |
| LocalWindowProxyManager& window_proxy_manager) { |
| return new ScriptController(frame, window_proxy_manager); |
| } |
| |
| DECLARE_TRACE(); |
| |
| // This returns an initialized window proxy. (If the window proxy is not |
| // yet initialized, it's implicitly initialized at the first access.) |
| LocalWindowProxy* WindowProxy(DOMWrapperWorld& world) { |
| return window_proxy_manager_->WindowProxy(world); |
| } |
| |
| // Evaluate JavaScript in the main world. |
| void ExecuteScriptInMainWorld( |
| const String&, |
| ExecuteScriptPolicy = kDoNotExecuteScriptWhenScriptsDisabled); |
| void ExecuteScriptInMainWorld(const ScriptSourceCode&, |
| AccessControlStatus = kNotSharableCrossOrigin); |
| v8::Local<v8::Value> ExecuteScriptInMainWorldAndReturnValue( |
| const ScriptSourceCode&, |
| ExecuteScriptPolicy = kDoNotExecuteScriptWhenScriptsDisabled); |
| v8::Local<v8::Value> ExecuteScriptAndReturnValue( |
| v8::Local<v8::Context>, |
| const ScriptSourceCode&, |
| AccessControlStatus = kNotSharableCrossOrigin); |
| |
| // Executes JavaScript in an isolated world. The script gets its own global |
| // scope, its own prototypes for intrinsic JavaScript objects (String, Array, |
| // and so-on), and its own wrappers for all DOM nodes and DOM constructors. |
| // |
| // If an isolated world with the specified ID already exists, it is reused. |
| // Otherwise, a new world is created. |
| // |
| // FIXME: We don't want to support multiple scripts. |
| void ExecuteScriptInIsolatedWorld(int world_id, |
| const HeapVector<ScriptSourceCode>& sources, |
| Vector<v8::Local<v8::Value>>* results); |
| |
| // Returns true if argument is a JavaScript URL. |
| bool ExecuteScriptIfJavaScriptURL(const KURL&, Element*); |
| |
| // Creates a new isolated world for DevTools with the given human readable |
| // |world_name| and returns it's id or DOMWrapperWorld::kInvalidWorldId on |
| // failure. |
| int CreateNewDInspectorIsolatedWorld(const String& world_name); |
| |
| // Returns true if the current world is isolated, and has its own Content |
| // Security Policy. In this case, the policy of the main world should be |
| // ignored when evaluating resources injected into the DOM. |
| bool ShouldBypassMainWorldCSP(); |
| |
| void EnableEval(); |
| void DisableEval(const String& error_message); |
| |
| TextPosition EventHandlerPosition() const; |
| |
| void ClearWindowProxy(); |
| void UpdateDocument(); |
| |
| void UpdateSecurityOrigin(SecurityOrigin*); |
| |
| void ClearForClose(); |
| |
| // Registers a v8 extension to be available on webpages. Will only |
| // affect v8 contexts initialized after this call. Takes ownership of |
| // the v8::Extension object passed. |
| static void RegisterExtensionIfNeeded(v8::Extension*); |
| static V8Extensions& RegisteredExtensions(); |
| |
| private: |
| ScriptController(LocalFrame& frame, |
| LocalWindowProxyManager& window_proxy_manager) |
| : frame_(&frame), window_proxy_manager_(&window_proxy_manager) {} |
| |
| LocalFrame* GetFrame() const { return frame_; } |
| v8::Isolate* GetIsolate() const { |
| return window_proxy_manager_->GetIsolate(); |
| } |
| |
| v8::Local<v8::Value> EvaluateScriptInMainWorld(const ScriptSourceCode&, |
| AccessControlStatus, |
| ExecuteScriptPolicy); |
| |
| const Member<LocalFrame> frame_; |
| const Member<LocalWindowProxyManager> window_proxy_manager_; |
| }; |
| |
| } // namespace blink |
| |
| #endif // ScriptController_h |