ObjectEnvironment.cs 5.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192
  1. using System.Diagnostics.CodeAnalysis;
  2. using Jint.Native;
  3. using Jint.Native.Object;
  4. using Jint.Native.Symbol;
  5. using Jint.Runtime.Descriptors;
  6. namespace Jint.Runtime.Environments;
  7. /// <summary>
  8. /// Represents an object environment record
  9. /// https://tc39.es/ecma262/#sec-object-environment-records
  10. /// </summary>
  11. internal sealed class ObjectEnvironment : Environment
  12. {
  13. internal readonly ObjectInstance _bindingObject;
  14. private readonly bool _provideThis;
  15. private readonly bool _withEnvironment;
  16. public ObjectEnvironment(
  17. Engine engine,
  18. ObjectInstance bindingObject,
  19. bool provideThis,
  20. bool withEnvironment) : base(engine)
  21. {
  22. _bindingObject = bindingObject;
  23. _provideThis = provideThis;
  24. _withEnvironment = withEnvironment;
  25. }
  26. internal override bool HasBinding(Key name)
  27. {
  28. var property = new JsString(name.Name);
  29. var foundBinding = HasProperty(property);
  30. if (!foundBinding)
  31. {
  32. return false;
  33. }
  34. if (!_withEnvironment)
  35. {
  36. return true;
  37. }
  38. return !IsBlocked(property);
  39. }
  40. internal override bool HasBinding(BindingName name)
  41. {
  42. var foundBinding = HasProperty(name.Value);
  43. if (!foundBinding)
  44. {
  45. return false;
  46. }
  47. if (!_withEnvironment)
  48. {
  49. return true;
  50. }
  51. return !IsBlocked(name.Value);
  52. }
  53. private bool HasProperty(JsValue property)
  54. {
  55. return _bindingObject.HasProperty(property);
  56. }
  57. internal override bool TryGetBinding(BindingName name, [NotNullWhen(true)] out JsValue? value)
  58. {
  59. // we unwrap by name
  60. if (!HasProperty(name.Value))
  61. {
  62. value = default;
  63. return false;
  64. }
  65. if (_withEnvironment && IsBlocked(name.Value))
  66. {
  67. value = default;
  68. return false;
  69. }
  70. value = _bindingObject.Get(name.Value);
  71. return true;
  72. }
  73. private bool IsBlocked(JsValue property)
  74. {
  75. var unscopables = _bindingObject.Get(GlobalSymbolRegistry.Unscopables);
  76. if (unscopables is ObjectInstance oi)
  77. {
  78. var blocked = TypeConverter.ToBoolean(oi.Get(property));
  79. if (blocked)
  80. {
  81. return true;
  82. }
  83. }
  84. return false;
  85. }
  86. /// <summary>
  87. /// http://www.ecma-international.org/ecma-262/6.0/#sec-object-environment-records-createmutablebinding-n-d
  88. /// </summary>
  89. internal override void CreateMutableBinding(Key name, bool canBeDeleted = false)
  90. {
  91. _bindingObject.DefinePropertyOrThrow(name.Name, new PropertyDescriptor(Undefined, canBeDeleted
  92. ? PropertyFlag.ConfigurableEnumerableWritable | PropertyFlag.MutableBinding
  93. : PropertyFlag.NonConfigurable | PropertyFlag.MutableBinding));
  94. }
  95. /// <summary>
  96. /// https://tc39.es/ecma262/#sec-object-environment-records-createimmutablebinding-n-s
  97. /// </summary>
  98. internal override void CreateImmutableBinding(Key name, bool strict = true)
  99. {
  100. ExceptionHelper.ThrowInvalidOperationException("The concrete Environment Record method CreateImmutableBinding is never used within this specification in association with Object Environment Records.");
  101. }
  102. /// <summary>
  103. /// https://tc39.es/ecma262/#sec-object-environment-records-initializebinding-n-v
  104. /// </summary>
  105. internal override void InitializeBinding(Key name, JsValue value) => SetMutableBinding(name, value, strict: false);
  106. internal override void SetMutableBinding(Key name, JsValue value, bool strict)
  107. {
  108. var jsString = new JsString(name);
  109. if (strict && !_bindingObject.HasProperty(jsString))
  110. {
  111. ExceptionHelper.ThrowReferenceNameError(_engine.Realm, name);
  112. }
  113. _bindingObject.Set(jsString, value);
  114. }
  115. internal override void SetMutableBinding(BindingName name, JsValue value, bool strict)
  116. {
  117. if (strict && !_bindingObject.HasProperty(name.Value))
  118. {
  119. ExceptionHelper.ThrowReferenceNameError(_engine.Realm, name.Key);
  120. }
  121. _bindingObject.Set(name.Value, value);
  122. }
  123. internal override JsValue GetBindingValue(Key name, bool strict)
  124. {
  125. if (!_bindingObject.TryGetValue(name.Name, out var value) && strict)
  126. {
  127. ExceptionHelper.ThrowReferenceNameError(_engine.Realm, name.Name);
  128. }
  129. return value;
  130. }
  131. internal override bool DeleteBinding(Key name) => _bindingObject.Delete(name.Name);
  132. internal override bool HasThisBinding() => false;
  133. internal override bool HasSuperBinding() => false;
  134. internal override JsValue WithBaseObject() => _withEnvironment ? _bindingObject : Undefined;
  135. internal override bool HasBindings() => _bindingObject._properties?.Count > 0;
  136. internal override string[] GetAllBindingNames()
  137. {
  138. if (_bindingObject is not null)
  139. {
  140. var names = new List<string>(_bindingObject._properties?.Count ?? 0);
  141. foreach (var name in _bindingObject.GetOwnProperties())
  142. {
  143. names.Add(name.Key.ToString());
  144. }
  145. return names.ToArray();
  146. }
  147. return Array.Empty<string>();
  148. }
  149. public override bool Equals(JsValue? other)
  150. {
  151. return ReferenceEquals(_bindingObject, other);
  152. }
  153. internal override JsValue GetThisBinding()
  154. {
  155. throw new NotImplementedException();
  156. }
  157. }