diff options
Diffstat (limited to 'dom/base/nsIScriptContext.h')
-rw-r--r-- | dom/base/nsIScriptContext.h | 111 |
1 files changed, 111 insertions, 0 deletions
diff --git a/dom/base/nsIScriptContext.h b/dom/base/nsIScriptContext.h new file mode 100644 index 0000000000..8274e22f9a --- /dev/null +++ b/dom/base/nsIScriptContext.h @@ -0,0 +1,111 @@ +/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* vim: set ts=8 sts=2 et sw=2 tw=80: */ +/* 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 "jspubtd.h" +#include "js/GCAPI.h" + +class nsIScriptGlobalObject; + +#define NS_ISCRIPTCONTEXT_IID \ +{ 0x54cbe9cf, 0x7282, 0x421a, \ + { 0x91, 0x6f, 0xd0, 0x70, 0x73, 0xde, 0xb8, 0xc0 } } + +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; + + /** + * 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; + + // SetProperty is suspect and jst believes should not be needed. Currenly + // used only for "arguments". + virtual nsresult SetProperty(JS::Handle<JSObject*> 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<JSObject*> 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<JSObject*> aWindowProxy) = 0; + virtual JSObject* GetWindowProxy() = 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__ |