mirror of
				https://github.com/LadybirdBrowser/ladybird.git
				synced 2025-10-31 13:20:59 +00:00 
			
		
		
		
	 f87041bf3a
			
		
	
	
		f87041bf3a
		
	
	
	
	
		
			
			Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
		
			
				
	
	
		
			80 lines
		
	
	
	
		
			3.4 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			80 lines
		
	
	
	
		
			3.4 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| /*
 | |
|  * Copyright (c) 2022, David Tuin <davidot@serenityos.org>
 | |
|  * Copyright (c) 2023, networkException <networkexception@serenityos.org>
 | |
|  *
 | |
|  * SPDX-License-Identifier: BSD-2-Clause
 | |
|  */
 | |
| 
 | |
| #pragma once
 | |
| 
 | |
| #include <LibJS/Forward.h>
 | |
| #include <LibJS/Module.h>
 | |
| 
 | |
| namespace JS {
 | |
| 
 | |
| enum class ModuleStatus {
 | |
|     New,
 | |
|     Unlinked,
 | |
|     Linking,
 | |
|     Linked,
 | |
|     Evaluating,
 | |
|     EvaluatingAsync,
 | |
|     Evaluated
 | |
| };
 | |
| 
 | |
| // 16.2.1.5 Cyclic Module Records, https://tc39.es/ecma262/#cyclic-module-record
 | |
| class CyclicModule : public Module {
 | |
|     GC_CELL(CyclicModule, Module);
 | |
|     GC_DECLARE_ALLOCATOR(CyclicModule);
 | |
| 
 | |
| public:
 | |
|     virtual ~CyclicModule() override;
 | |
| 
 | |
|     // Note: Do not call these methods directly unless you are HostResolveImportedModule.
 | |
|     //       Badges cannot be used because other hosts must be able to call this (and it is called recursively)
 | |
|     virtual ThrowCompletionOr<void> link(VM& vm) override final;
 | |
|     virtual ThrowCompletionOr<Promise*> evaluate(VM& vm) override final;
 | |
| 
 | |
|     virtual PromiseCapability& load_requested_modules(GC::Ptr<GraphLoadingState::HostDefined>) override;
 | |
|     virtual void inner_module_loading(GraphLoadingState& state);
 | |
| 
 | |
|     Vector<ModuleRequest> const& requested_modules() const { return m_requested_modules; }
 | |
|     Vector<ModuleWithSpecifier> const& loaded_modules() const { return m_loaded_modules; }
 | |
|     Vector<ModuleWithSpecifier>& loaded_modules() { return m_loaded_modules; }
 | |
| 
 | |
| protected:
 | |
|     CyclicModule(Realm& realm, StringView filename, bool has_top_level_await, Vector<ModuleRequest> requested_modules, Script::HostDefined* host_defined);
 | |
| 
 | |
|     virtual void visit_edges(Cell::Visitor&) override;
 | |
| 
 | |
|     virtual ThrowCompletionOr<u32> inner_module_linking(VM& vm, Vector<Module*>& stack, u32 index) override final;
 | |
|     virtual ThrowCompletionOr<u32> inner_module_evaluation(VM& vm, Vector<Module*>& stack, u32 index) override final;
 | |
| 
 | |
|     virtual ThrowCompletionOr<void> initialize_environment(VM& vm);
 | |
|     virtual ThrowCompletionOr<void> execute_module(VM& vm, GC::Ptr<PromiseCapability> capability = {});
 | |
| 
 | |
|     [[nodiscard]] GC::Ref<Module> get_imported_module(ModuleRequest const&);
 | |
| 
 | |
|     void execute_async_module(VM& vm);
 | |
|     void gather_available_ancestors(Vector<CyclicModule*>& exec_list);
 | |
|     void async_module_execution_fulfilled(VM& vm);
 | |
|     void async_module_execution_rejected(VM& vm, Value error);
 | |
| 
 | |
|     ModuleStatus m_status { ModuleStatus::New };          // [[Status]]
 | |
|     ThrowCompletionOr<void> m_evaluation_error;           // [[EvaluationError]]
 | |
|     Optional<u32> m_dfs_index;                            // [[DFSIndex]]
 | |
|     Optional<u32> m_dfs_ancestor_index;                   // [[DFSAncestorIndex]]
 | |
|     Vector<ModuleRequest> m_requested_modules;            // [[RequestedModules]]
 | |
|     Vector<ModuleWithSpecifier> m_loaded_modules;         // [[LoadedModules]]
 | |
|     GC::Ptr<CyclicModule> m_cycle_root;                   // [[CycleRoot]]
 | |
|     bool m_has_top_level_await { false };                 // [[HasTLA]]
 | |
|     bool m_async_evaluation { false };                    // [[AsyncEvaluation]]
 | |
|     GC::Ptr<PromiseCapability> m_top_level_capability;    // [[TopLevelCapability]]
 | |
|     Vector<GC::Ptr<CyclicModule>> m_async_parent_modules; // [[AsyncParentModules]]
 | |
|     Optional<u32> m_pending_async_dependencies;           // [[PendingAsyncDependencies]]
 | |
| };
 | |
| 
 | |
| void continue_module_loading(GraphLoadingState&, ThrowCompletionOr<GC::Ref<Module>> const&);
 | |
| void continue_dynamic_import(GC::Ref<PromiseCapability>, ThrowCompletionOr<GC::Ref<Module>> const& module_completion);
 | |
| 
 | |
| }
 |