[ES6 modules] Introduce ModuleMap

third_party/WebKit/Source/core/dom/Modulator.h

 // Copyright 2017 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef Modulator_h
 #define Modulator_h
 
 #include "core/CoreExport.h"
 #include "platform/heap/Handle.h"
 #include "platform/weborigin/KURL.h"
 
 namespace blink {
 
 class LocalFrame;
+class ModuleScript;
+class ModuleScriptFetchRequest;
+class ModuleScriptLoaderClient;
+class ScriptModuleResolver;
+class WebTaskRunner;
+
+// A SingleModuleClient is notified when single module script node (node as in a
+// module tree graph) load is complete and its corresponding entry is created in
+// module map.
+class SingleModuleClient : public GarbageCollectedMixin {
+ public:
+  virtual void notifyModuleLoadFinished(ModuleScript*) = 0;
+};
+
+// spec: "top-level module fetch flag"

[hiroshige, 2017/02/22 01:21:30]

+link?

[kouhei (in TOK), 2017/02/22 07:08:04]

Done.

+enum class ModuleGraphLevel { TopLevelModuleFetch, DependentModuleFetch };
 
 // A Modulator is an interface for "environment settings object" concept for
 // module scripts.
 // https://html.spec.whatwg.org/#environment-settings-object
 //
 // A Modulator also serves as an entry point for various module spec algorithms.
 class CORE_EXPORT Modulator : public GarbageCollectedMixin {
  public:
   static Modulator* from(LocalFrame*);
 
+  virtual ScriptModuleResolver* scriptModuleResolver() = 0;
+  virtual WebTaskRunner* taskRunner() = 0;
+
   // https://html.spec.whatwg.org/#resolve-a-module-specifier
   static KURL resolveModuleSpecifier(const String& moduleRequest,
                                      const KURL& baseURL);
+
+ private:
+  friend class ModuleMap;
+
+  // Asynchronously fetches a single module script.

[hiroshige, 2017/02/22 01:21:29]

If ModuleScriptLoader::fetch() can notify ModuleScriptLoaderClient
synchronously, "Asynchronously fetches" looks inconsistent (a single module
script might be fetched synchronously and ModuleMap triggers notification
asynchronously, so at this point fetchNewSingleModule() can be synchronous.)

[kouhei (in TOK), 2017/02/22 07:08:04]

Done.

+  // This is triggered from fetchSingle() implementation (which is ModuleMap) if

[hiroshige, 2017/02/22 01:21:29]

nit: s/which is/which is in/?

[kouhei (in TOK), 2017/02/22 07:08:04]

Done.

+  // the cached entry doesn't exist.
+  virtual void fetchNewSingleModule(const ModuleScriptFetchRequest&,
+                                    ModuleGraphLevel,
+                                    ModuleScriptLoaderClient*) = 0;
 };
 
 }  // namespace blink
 
 #endif