DeclarativeEnvironmentRecord.cs 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187
  1. using System.Diagnostics.CodeAnalysis;
  2. using System.Runtime.CompilerServices;
  3. using Jint.Collections;
  4. using Jint.Native;
  5. namespace Jint.Runtime.Environments
  6. {
  7. /// <summary>
  8. /// Represents a declarative environment record
  9. /// https://tc39.es/ecma262/#sec-declarative-environment-records
  10. /// </summary>
  11. internal class DeclarativeEnvironmentRecord : EnvironmentRecord
  12. {
  13. internal readonly HybridDictionary<Binding> _dictionary = new();
  14. internal readonly bool _catchEnvironment;
  15. public DeclarativeEnvironmentRecord(Engine engine, bool catchEnvironment = false) : base(engine)
  16. {
  17. _catchEnvironment = catchEnvironment;
  18. }
  19. public sealed override bool HasBinding(string name)
  20. {
  21. return _dictionary.ContainsKey(name);
  22. }
  23. internal sealed override bool HasBinding(in BindingName name)
  24. {
  25. return _dictionary.ContainsKey(name.Key);
  26. }
  27. internal override bool TryGetBinding(
  28. in BindingName name,
  29. bool strict,
  30. out Binding binding,
  31. [NotNullWhen(true)] out JsValue? value)
  32. {
  33. binding = default;
  34. var success = _dictionary.TryGetValue(name.Key, out binding);
  35. value = success && binding.IsInitialized() ? binding.Value : default;
  36. return success;
  37. }
  38. internal void CreateMutableBindingAndInitialize(Key name, bool canBeDeleted, JsValue value)
  39. {
  40. _dictionary[name] = new Binding(value, canBeDeleted, mutable: true, strict: false);
  41. }
  42. internal void CreateImmutableBindingAndInitialize(Key name, bool strict, JsValue value)
  43. {
  44. _dictionary[name] = new Binding(value, canBeDeleted: false, mutable: false, strict);
  45. }
  46. public sealed override void CreateMutableBinding(string name, bool canBeDeleted = false)
  47. {
  48. _dictionary[name] = new Binding(null!, canBeDeleted, mutable: true, strict: false);
  49. }
  50. public sealed override void CreateImmutableBinding(string name, bool strict = true)
  51. {
  52. _dictionary[name] = new Binding(null!, canBeDeleted: false, mutable: false, strict);
  53. }
  54. public sealed override void InitializeBinding(string name, JsValue value)
  55. {
  56. _dictionary.SetOrUpdateValue(name, static (current, value) => current.ChangeValue(value), value);
  57. }
  58. internal sealed override void SetMutableBinding(in BindingName name, JsValue value, bool strict)
  59. {
  60. SetMutableBinding(name.Key.Name, value, strict);
  61. }
  62. public sealed override void SetMutableBinding(string name, JsValue value, bool strict)
  63. {
  64. var key = (Key) name;
  65. if (!_dictionary.TryGetValue(key, out var binding))
  66. {
  67. if (strict)
  68. {
  69. ExceptionHelper.ThrowReferenceNameError(_engine.Realm, name);
  70. }
  71. CreateMutableBindingAndInitialize(key, canBeDeleted: true, value);
  72. return;
  73. }
  74. if (binding.Strict)
  75. {
  76. strict = true;
  77. }
  78. // Is it an uninitialized binding?
  79. if (!binding.IsInitialized())
  80. {
  81. ThrowUninitializedBindingError(name);
  82. }
  83. if (binding.Mutable)
  84. {
  85. _dictionary[key] = binding.ChangeValue(value);
  86. }
  87. else
  88. {
  89. if (strict)
  90. {
  91. ExceptionHelper.ThrowTypeError(_engine.Realm, "Assignment to constant variable.");
  92. }
  93. }
  94. }
  95. public override JsValue GetBindingValue(string name, bool strict)
  96. {
  97. _dictionary.TryGetValue(name, out var binding);
  98. if (binding.IsInitialized())
  99. {
  100. return binding.Value;
  101. }
  102. ThrowUninitializedBindingError(name);
  103. return null!;
  104. }
  105. internal sealed override bool TryGetBindingValue(string name, bool strict, [NotNullWhen(true)] out JsValue? value)
  106. {
  107. _dictionary.TryGetValue(name, out var binding);
  108. if (binding.IsInitialized())
  109. {
  110. value = binding.Value;
  111. return true;
  112. }
  113. value = null;
  114. return false;
  115. }
  116. [MethodImpl(MethodImplOptions.NoInlining)]
  117. private void ThrowUninitializedBindingError(string name)
  118. {
  119. ExceptionHelper.ThrowReferenceError(_engine.Realm, $"Cannot access '{name}' before initialization");
  120. }
  121. public sealed override bool DeleteBinding(string name)
  122. {
  123. if (!_dictionary.TryGetValue(name, out var binding))
  124. {
  125. return true;
  126. }
  127. if (!binding.CanBeDeleted)
  128. {
  129. return false;
  130. }
  131. _dictionary.Remove(name);
  132. return true;
  133. }
  134. public override bool HasThisBinding() => false;
  135. public override bool HasSuperBinding() => false;
  136. public sealed override JsValue WithBaseObject() => Undefined;
  137. /// <inheritdoc />
  138. internal sealed override string[] GetAllBindingNames()
  139. {
  140. if (_dictionary is null)
  141. {
  142. return Array.Empty<string>();
  143. }
  144. var keys = new string[_dictionary.Count];
  145. var n = 0;
  146. foreach (var entry in _dictionary)
  147. {
  148. keys[n++] = entry.Key;
  149. }
  150. return keys;
  151. }
  152. public override JsValue GetThisBinding()
  153. {
  154. return Undefined;
  155. }
  156. }
  157. }