/* * Copyright (c) 2021, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include namespace JS::Bytecode { class InstructionStreamIterator; class Interpreter { public: explicit Interpreter(VM&); ~Interpreter(); [[nodiscard]] Realm& realm() { return *m_realm; } [[nodiscard]] Object& global_object() { return *m_global_object; } [[nodiscard]] DeclarativeEnvironment& global_declarative_environment() { return *m_global_declarative_environment; } VM& vm() { return m_vm; } VM const& vm() const { return m_vm; } ThrowCompletionOr run(Script&, JS::GCPtr lexical_environment_override = nullptr); ThrowCompletionOr run(SourceTextModule&); ThrowCompletionOr run(Bytecode::Executable& executable, Optional entry_point = {}, Value initial_accumulator_value = {}) { auto result_and_return_register = run_executable(executable, entry_point, initial_accumulator_value); return move(result_and_return_register.value); } struct ResultAndReturnRegister { ThrowCompletionOr value; Value return_register_value; }; ResultAndReturnRegister run_executable(Bytecode::Executable&, Optional entry_point, Value initial_accumulator_value = {}); ALWAYS_INLINE Value& accumulator() { return reg(Register::accumulator()); } ALWAYS_INLINE Value& saved_return_value() { return reg(Register::saved_return_value()); } Value& reg(Register const& r) { return m_registers.data()[r.index()]; } Value reg(Register const& r) const { return m_registers.data()[r.index()]; } [[nodiscard]] Value get(Operand) const; void set(Operand, Value); void do_return(Value value) { reg(Register::return_value()) = value; reg(Register::exception()) = {}; } void enter_unwind_context(); void leave_unwind_context(); void catch_exception(Operand dst); void restore_scheduled_jump(); void leave_finally(); void enter_object_environment(Object&); Executable& current_executable() { return *m_current_executable; } Executable const& current_executable() const { return *m_current_executable; } Optional program_counter() const { return m_program_counter; } Vector& registers() { return vm().running_execution_context().registers; } Vector const& registers() const { return vm().running_execution_context().registers; } private: void run_bytecode(size_t entry_point); enum class HandleExceptionResponse { ExitFromExecutable, ContinueInThisExecutable, }; [[nodiscard]] HandleExceptionResponse handle_exception(size_t& program_counter, Value exception); VM& m_vm; Optional m_scheduled_jump; GCPtr m_current_executable { nullptr }; GCPtr m_realm { nullptr }; GCPtr m_global_object { nullptr }; GCPtr m_global_declarative_environment { nullptr }; Optional m_program_counter; Span m_registers; Span m_locals; Span m_constants; }; extern bool g_dump_bytecode; ThrowCompletionOr> compile(VM&, ASTNode const&, ReadonlySpan, JS::FunctionKind kind, DeprecatedFlyString const& name); }