sebastienros.jint/Jint/Runtime/Debugger/CallFrame.cs

using Jint.Native;
using Jint.Runtime.CallStack;
using Environment = Jint.Runtime.Environments.Environment;

namespace Jint.Runtime.Debugger;

public sealed class CallFrame
{
    private readonly CallStackExecutionContext _context;
    private SourceLocation _location;
    private readonly CallStackElement? _element;
    private readonly Lazy<DebugScopes> _scopeChain;

    internal CallFrame(
        CallStackElement? element,
        in CallStackExecutionContext context,
        in SourceLocation location,
        JsValue? returnValue)
    {
        _element = element;
        _context = context;
        _location = location;
        ReturnValue = returnValue;

        _scopeChain = new Lazy<DebugScopes>(() => new DebugScopes(Environment));
    }

    private Environment Environment => _context.LexicalEnvironment;

    // TODO: CallFrameId
    /// <summary>
    /// Name of the function of this call frame. For global scope, this will be "(anonymous)".
    /// </summary>
    public string FunctionName => _element?.ToString() ?? "(anonymous)";

    /// <summary>
    /// Source location of function of this call frame.
    /// </summary>
    /// <remarks>For top level (global) call frames, as well as functions not defined in script, this will be null.</remarks>
    public SourceLocation? FunctionLocation => (_element?.Function._functionDefinition?.Function as Node)?.Location;

    /// <summary>
    /// Currently executing source location in this call frame.
    /// </summary>
    public ref SourceLocation Location => ref _location;

    /// <summary>
    /// The scope chain of this call frame.
    /// </summary>
    public DebugScopes ScopeChain => _scopeChain.Value;

    /// <summary>
    /// The value of <c>this</c> in this call frame.
    /// </summary>
    public JsValue This
    {
        get
        {
            var environment = _context.GetThisEnvironment();
            return environment.GetThisBinding();
        }
    }

    /// <summary>
    /// The return value of this call frame. Will be null for call frames that aren't at the top of the stack,
    /// as well as if execution is not at a return point.
    /// </summary>
    public JsValue? ReturnValue { get; }
}