/* * Copyright (c) 2020, Andreas Kling * Copyright (c) 2022, Luke Wilde * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace JS { struct ExecutingASTNodeChain { ExecutingASTNodeChain* previous { nullptr }; ASTNode const& node; }; class Interpreter : public Weakable { public: template static NonnullOwnPtr create(VM& vm, Args&&... args) requires(IsBaseOf) { DeferGC defer_gc(vm.heap()); auto interpreter = adopt_own(*new Interpreter(vm)); VM::InterpreterExecutionScope scope(*interpreter); GlobalObject* global_object { nullptr }; interpreter->m_global_execution_context = MUST(Realm::initialize_host_defined_realm( vm, [&](Realm& realm) -> Value { global_object = interpreter->heap().allocate_without_global_object(realm, forward(args)...); return global_object; }, [](Realm&) -> Value { return js_undefined(); })); // NOTE: These are not in the spec. static FlyString global_execution_context_name = "(global execution context)"; interpreter->m_global_execution_context->function_name = global_execution_context_name; interpreter->m_global_object = make_handle(global_object); interpreter->m_realm = make_handle(global_object->associated_realm()); return interpreter; } static NonnullOwnPtr create_with_existing_realm(Realm&); ~Interpreter() = default; ThrowCompletionOr run(Script&); ThrowCompletionOr run(SourceTextModule&); GlobalObject& global_object(); GlobalObject const& global_object() const; Realm& realm(); Realm const& realm() const; ALWAYS_INLINE VM& vm() { return *m_vm; } ALWAYS_INLINE const VM& vm() const { return *m_vm; } ALWAYS_INLINE Heap& heap() { return vm().heap(); } Environment* lexical_environment() { return vm().lexical_environment(); } void push_ast_node(ExecutingASTNodeChain& chain_node) { chain_node.previous = m_ast_node_chain; m_ast_node_chain = &chain_node; } void pop_ast_node() { VERIFY(m_ast_node_chain); m_ast_node_chain = m_ast_node_chain->previous; } ASTNode const* current_node() const { return m_ast_node_chain ? &m_ast_node_chain->node : nullptr; } private: explicit Interpreter(VM&); ExecutingASTNodeChain* m_ast_node_chain { nullptr }; NonnullRefPtr m_vm; Handle m_global_object; Handle m_realm; // This is here to keep the global execution context alive for the entire lifespan of the Interpreter. OwnPtr m_global_execution_context; }; }