dom/script/ModuleLoader.h

   1 /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* vim: set ts=8 sts=2 et sw=2 tw=80: */
   3 /* This Source Code Form is subject to the terms of the Mozilla Public
   4  * License, v. 2.0. If a copy of the MPL was not distributed with this
   5  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7 #ifndef mozilla_dom_ModuleLoader_h
   8 #define mozilla_dom_ModuleLoader_h
   9
  10 #include "mozilla/dom/ScriptLoadContext.h"
  11 #include "js/loader/ModuleLoaderBase.h"
  12 #include "js/loader/ScriptLoadRequest.h"
  13 #include "ScriptLoader.h"
  14
  15 class nsIURI;
  16
  17 namespace JS {
  18
  19 class CompileOptions;
  20
  21 namespace loader {
  22
  23 class ModuleLoadRequest;
  24
  25 }  // namespace loader
  26 }  // namespace JS
  27
  28 namespace mozilla::dom {
  29
  30 class ScriptLoader;
  31 class SRIMetadata;
  32
  33 //////////////////////////////////////////////////////////////
  34 // DOM Module loader implementation
  35 //////////////////////////////////////////////////////////////
  36
  37 class ModuleLoader final : public JS::loader::ModuleLoaderBase {
  38  private:
  39   virtual ~ModuleLoader();
  40
  41  public:
  42   enum Kind { Normal, WebExtension };
  43
  44   ModuleLoader(ScriptLoader* aLoader, nsIGlobalObject* aGlobalObject,
  45                Kind aKind);
  46
  47   Kind GetKind() const { return mKind; }
  48
  49   ScriptLoader* GetScriptLoader();
  50
  51   bool CanStartLoad(ModuleLoadRequest* aRequest, nsresult* aRvOut) override;
  52
  53   nsresult StartFetch(ModuleLoadRequest* aRequest) override;
  54
  55   void OnModuleLoadComplete(ModuleLoadRequest* aRequest) override;
  56
  57   nsresult CompileFetchedModule(
  58       JSContext* aCx, JS::Handle<JSObject*> aGlobal,
  59       JS::CompileOptions& aOptions, ModuleLoadRequest* aRequest,
  60       JS::MutableHandle<JSObject*> aModuleScript) override;
  61
  62   // Create a top-level module load request.
  63   static already_AddRefed<ModuleLoadRequest> CreateTopLevel(
  64       nsIURI* aURI, ReferrerPolicy aReferrerPolicy,
  65       ScriptFetchOptions* aFetchOptions, const SRIMetadata& aIntegrity,
  66       nsIURI* aReferrer, ScriptLoader* aLoader, ScriptLoadContext* aContext);
  67
  68   // Create a module load request for a static module import.
  69   already_AddRefed<ModuleLoadRequest> CreateStaticImport(
  70       nsIURI* aURI, ModuleLoadRequest* aParent) override;
  71
  72   // Create a module load request for a dynamic module import.
  73   already_AddRefed<ModuleLoadRequest> CreateDynamicImport(
  74       JSContext* aCx, nsIURI* aURI, LoadedScript* aMaybeActiveScript,
  75       JS::Handle<JS::Value> aReferencingPrivate,
  76       JS::Handle<JSString*> aSpecifier,
  77       JS::Handle<JSObject*> aPromise) override;
  78
  79   static ModuleLoader* From(ModuleLoaderBase* aLoader) {
  80     return static_cast<ModuleLoader*>(aLoader);
  81   }
  82
  83   void AsyncExecuteInlineModule(ModuleLoadRequest* aRequest);
  84   void ExecuteInlineModule(ModuleLoadRequest* aRequest);
  85
  86  private:
  87   const Kind mKind;
  88 };
  89
  90 }  // namespace mozilla::dom
  91
  92 #endif  // mozilla_dom_ModuleLoader_h