ladybird/Userland/Libraries/LibJS/Runtime/EnvironmentRecord.h

/*
 * Copyright (c) 2020-2021, Andreas Kling <kling@serenityos.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <LibJS/Runtime/Object.h>

namespace JS {

struct Variable {
    Value value;
    DeclarationKind declaration_kind;
};

class EnvironmentRecord : public Object {
    JS_OBJECT(EnvironmentRecord, Object);

public:
    GlobalObject& global_object() { return *m_global_object; }
    GlobalObject const& global_object() const { return *m_global_object; }

    virtual void initialize(GlobalObject&) override;

    virtual Optional<Variable> get_from_environment_record(FlyString const&) const = 0;
    virtual void put_into_environment_record(FlyString const&, Variable) = 0;
    virtual bool delete_from_environment_record(FlyString const&) = 0;

    virtual bool has_this_binding() const { return false; }
    virtual Value get_this_binding(GlobalObject&) const { return {}; }

    virtual bool has_binding([[maybe_unused]] FlyString const& name) const { return false; }
    virtual void create_mutable_binding(GlobalObject&, [[maybe_unused]] FlyString const& name, [[maybe_unused]] bool can_be_deleted) { }
    virtual void create_immutable_binding(GlobalObject&, [[maybe_unused]] FlyString const& name, [[maybe_unused]] bool strict) { }
    virtual void initialize_binding(GlobalObject&, [[maybe_unused]] FlyString const& name, Value) { }
    virtual void set_mutable_binding(GlobalObject&, [[maybe_unused]] FlyString const& name, Value, [[maybe_unused]] bool strict) { }
    virtual Value get_binding_value(GlobalObject&, [[maybe_unused]] FlyString const& name, [[maybe_unused]] bool strict) { return {}; }
    virtual bool delete_binding(GlobalObject&, [[maybe_unused]] FlyString const& name) { return false; }

    // [[OuterEnv]]
    EnvironmentRecord* outer_environment() { return m_outer_environment; }
    EnvironmentRecord const* outer_environment() const { return m_outer_environment; }

protected:
    explicit EnvironmentRecord(EnvironmentRecord* parent);

    virtual void visit_edges(Visitor&) override;

private:
    virtual bool is_environment_record() const final { return true; }

    GlobalObject* m_global_object { nullptr };
    EnvironmentRecord* m_outer_environment { nullptr };
};

}