diff -r 000000000000 -r 6474c204b198 dom/base/nsIScriptContext.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/dom/base/nsIScriptContext.h Wed Dec 31 06:09:35 2014 +0100 @@ -0,0 +1,141 @@ +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +#ifndef nsIScriptContext_h__ +#define nsIScriptContext_h__ + +#include "nscore.h" +#include "nsStringGlue.h" +#include "nsISupports.h" +#include "nsCOMPtr.h" +#include "nsIProgrammingLanguage.h" +#include "jspubtd.h" +#include "js/GCAPI.h" + +class nsIScriptGlobalObject; +class nsIScriptSecurityManager; +class nsIPrincipal; +class nsIAtom; +class nsIArray; +class nsIVariant; +class nsIObjectInputStream; +class nsIObjectOutputStream; +class nsIScriptObjectPrincipal; +class nsIDOMWindow; +class nsIURI; + +#define NS_ISCRIPTCONTEXT_IID \ +{ 0x274840b6, 0x7349, 0x4798, \ + { 0xbe, 0x24, 0xbd, 0x75, 0xa6, 0x46, 0x99, 0xb7 } } + +/* This MUST match JSVERSION_DEFAULT. This version stuff if we don't + know what language we have is a little silly... */ +#define SCRIPTVERSION_DEFAULT JSVERSION_DEFAULT + +class nsIOffThreadScriptReceiver; + +/** + * It is used by the application to initialize a runtime and run scripts. + * A script runtime would implement this interface. + */ +class nsIScriptContext : public nsISupports +{ +public: + NS_DECLARE_STATIC_IID_ACCESSOR(NS_ISCRIPTCONTEXT_IID) + + /** + * Return the global object. + * + **/ + virtual nsIScriptGlobalObject *GetGlobalObject() = 0; + + /** + * Return the native script context + * + **/ + virtual JSContext* GetNativeContext() = 0; + + /** + * Initialize the context generally. Does not create a global object. + **/ + virtual nsresult InitContext() = 0; + + /** + * Check to see if context is as yet intialized. Used to prevent + * reentrancy issues during the initialization process. + * + * @return true if initialized, false if not + * + */ + virtual bool IsContextInitialized() = 0; + + /** + * For garbage collected systems, do a synchronous collection pass. + * May be a no-op on other systems + * + * @return NS_OK if the method is successful + */ + virtual void GC(JS::gcreason::Reason aReason) = 0; + + // SetProperty is suspect and jst believes should not be needed. Currenly + // used only for "arguments". + virtual nsresult SetProperty(JS::Handle aTarget, + const char* aPropName, nsISupports* aVal) = 0; + /** + * Called to set/get information if the script context is + * currently processing a script tag + */ + virtual bool GetProcessingScriptTag() = 0; + virtual void SetProcessingScriptTag(bool aResult) = 0; + + /** + * Initialize DOM classes on aGlobalObj, always call + * WillInitializeContext() before calling InitContext(), and always + * call DidInitializeContext() when a context is fully + * (successfully) initialized. + */ + virtual nsresult InitClasses(JS::Handle aGlobalObj) = 0; + + /** + * Tell the context we're about to be reinitialize it. + */ + virtual void WillInitializeContext() = 0; + + /** + * Tell the context we're done reinitializing it. + */ + virtual void DidInitializeContext() = 0; + + /** + * Access the Window Proxy. The setter should only be called by nsGlobalWindow. + */ + virtual void SetWindowProxy(JS::Handle aWindowProxy) = 0; + virtual JSObject* GetWindowProxy() = 0; + virtual JSObject* GetWindowProxyPreserveColor() = 0; +}; + +NS_DEFINE_STATIC_IID_ACCESSOR(nsIScriptContext, NS_ISCRIPTCONTEXT_IID) + +#define NS_IOFFTHREADSCRIPTRECEIVER_IID \ +{0x3a980010, 0x878d, 0x46a9, \ + {0x93, 0xad, 0xbc, 0xfd, 0xd3, 0x8e, 0xa0, 0xc2}} + +class nsIOffThreadScriptReceiver : public nsISupports +{ +public: + NS_DECLARE_STATIC_IID_ACCESSOR(NS_IOFFTHREADSCRIPTRECEIVER_IID) + + /** + * Notify this object that a previous CompileScript call specifying this as + * aOffThreadReceiver has completed. The script being passed in must be + * rooted before any call which could trigger GC. + */ + NS_IMETHOD OnScriptCompileComplete(JSScript* aScript, nsresult aStatus) = 0; +}; + +NS_DEFINE_STATIC_IID_ACCESSOR(nsIOffThreadScriptReceiver, NS_IOFFTHREADSCRIPTRECEIVER_IID) + +#endif // nsIScriptContext_h__ +