Object.cpp 41 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169
  1. /*
  2. * Copyright (c) 2020, Andreas Kling <kling@serenityos.org>
  3. * Copyright (c) 2020-2021, Linus Groh <linusg@serenityos.org>
  4. *
  5. * SPDX-License-Identifier: BSD-2-Clause
  6. */
  7. #include <AK/String.h>
  8. #include <AK/TemporaryChange.h>
  9. #include <LibJS/Interpreter.h>
  10. #include <LibJS/Runtime/AbstractOperations.h>
  11. #include <LibJS/Runtime/Accessor.h>
  12. #include <LibJS/Runtime/Array.h>
  13. #include <LibJS/Runtime/Error.h>
  14. #include <LibJS/Runtime/GlobalObject.h>
  15. #include <LibJS/Runtime/NativeFunction.h>
  16. #include <LibJS/Runtime/Object.h>
  17. #include <LibJS/Runtime/PropertyDescriptor.h>
  18. #include <LibJS/Runtime/ProxyObject.h>
  19. #include <LibJS/Runtime/Shape.h>
  20. #include <LibJS/Runtime/TemporaryClearException.h>
  21. #include <LibJS/Runtime/Value.h>
  22. namespace JS {
  23. // 10.1.12 OrdinaryObjectCreate ( proto [ , additionalInternalSlotsList ] ), https://tc39.es/ecma262/#sec-ordinaryobjectcreate
  24. Object* Object::create(GlobalObject& global_object, Object* prototype)
  25. {
  26. if (!prototype)
  27. return global_object.heap().allocate<Object>(global_object, *global_object.empty_object_shape());
  28. else if (prototype == global_object.object_prototype())
  29. return global_object.heap().allocate<Object>(global_object, *global_object.new_object_shape());
  30. else
  31. return global_object.heap().allocate<Object>(global_object, *prototype);
  32. }
  33. Object::Object(GlobalObjectTag)
  34. {
  35. // This is the global object
  36. m_shape = heap().allocate_without_global_object<Shape>(*this);
  37. }
  38. Object::Object(ConstructWithoutPrototypeTag, GlobalObject& global_object)
  39. {
  40. m_shape = heap().allocate_without_global_object<Shape>(global_object);
  41. }
  42. Object::Object(Object& prototype)
  43. {
  44. m_shape = prototype.global_object().empty_object_shape();
  45. set_prototype(&prototype);
  46. }
  47. Object::Object(Shape& shape)
  48. : m_shape(&shape)
  49. {
  50. m_storage.resize(shape.property_count());
  51. }
  52. void Object::initialize(GlobalObject&)
  53. {
  54. }
  55. Object::~Object()
  56. {
  57. }
  58. // 7.2 Testing and Comparison Operations, https://tc39.es/ecma262/#sec-testing-and-comparison-operations
  59. // 7.2.5 IsExtensible ( O ), https://tc39.es/ecma262/#sec-isextensible-o
  60. ThrowCompletionOr<bool> Object::is_extensible() const
  61. {
  62. // 1. Return ? O.[[IsExtensible]]().
  63. return internal_is_extensible();
  64. }
  65. // 7.3 Operations on Objects, https://tc39.es/ecma262/#sec-operations-on-objects
  66. // 7.3.2 Get ( O, P ), https://tc39.es/ecma262/#sec-get-o-p
  67. ThrowCompletionOr<Value> Object::get(PropertyName const& property_name) const
  68. {
  69. // 1. Assert: Type(O) is Object.
  70. // 2. Assert: IsPropertyKey(P) is true.
  71. VERIFY(property_name.is_valid());
  72. // 3. Return ? O.[[Get]](P, O).
  73. return TRY(internal_get(property_name, this));
  74. }
  75. // 7.3.3 GetV ( V, P ) is defined as Value::get().
  76. // 7.3.4 Set ( O, P, V, Throw ), https://tc39.es/ecma262/#sec-set-o-p-v-throw
  77. ThrowCompletionOr<bool> Object::set(PropertyName const& property_name, Value value, ShouldThrowExceptions throw_exceptions)
  78. {
  79. VERIFY(!value.is_empty());
  80. auto& vm = this->vm();
  81. // 1. Assert: Type(O) is Object.
  82. // 2. Assert: IsPropertyKey(P) is true.
  83. VERIFY(property_name.is_valid());
  84. // 3. Assert: Type(Throw) is Boolean.
  85. // 4. Let success be ? O.[[Set]](P, V, O).
  86. auto success = TRY(internal_set(property_name, value, this));
  87. // 5. If success is false and Throw is true, throw a TypeError exception.
  88. if (!success && throw_exceptions == ShouldThrowExceptions::Yes) {
  89. // FIXME: Improve/contextualize error message
  90. return vm.throw_completion<TypeError>(global_object(), ErrorType::ObjectSetReturnedFalse);
  91. }
  92. // 6. Return success.
  93. return success;
  94. }
  95. // 7.3.5 CreateDataProperty ( O, P, V ), https://tc39.es/ecma262/#sec-createdataproperty
  96. ThrowCompletionOr<bool> Object::create_data_property(PropertyName const& property_name, Value value)
  97. {
  98. // 1. Assert: Type(O) is Object.
  99. // 2. Assert: IsPropertyKey(P) is true.
  100. VERIFY(property_name.is_valid());
  101. // 3. Let newDesc be the PropertyDescriptor { [[Value]]: V, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: true }.
  102. auto new_descriptor = PropertyDescriptor {
  103. .value = value,
  104. .writable = true,
  105. .enumerable = true,
  106. .configurable = true,
  107. };
  108. // 4. Return ? O.[[DefineOwnProperty]](P, newDesc).
  109. return internal_define_own_property(property_name, new_descriptor);
  110. }
  111. // 7.3.6 CreateMethodProperty ( O, P, V ), https://tc39.es/ecma262/#sec-createmethodproperty
  112. ThrowCompletionOr<bool> Object::create_method_property(PropertyName const& property_name, Value value)
  113. {
  114. VERIFY(!value.is_empty());
  115. // 1. Assert: Type(O) is Object.
  116. // 2. Assert: IsPropertyKey(P) is true.
  117. VERIFY(property_name.is_valid());
  118. // 3. Let newDesc be the PropertyDescriptor { [[Value]]: V, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true }.
  119. auto new_descriptor = PropertyDescriptor {
  120. .value = value,
  121. .writable = true,
  122. .enumerable = false,
  123. .configurable = true,
  124. };
  125. // 4. Return ? O.[[DefineOwnProperty]](P, newDesc).
  126. return internal_define_own_property(property_name, new_descriptor);
  127. }
  128. // 7.3.7 CreateDataPropertyOrThrow ( O, P, V ), https://tc39.es/ecma262/#sec-createdatapropertyorthrow
  129. ThrowCompletionOr<bool> Object::create_data_property_or_throw(PropertyName const& property_name, Value value)
  130. {
  131. VERIFY(!value.is_empty());
  132. auto& vm = this->vm();
  133. // 1. Assert: Type(O) is Object.
  134. // 2. Assert: IsPropertyKey(P) is true.
  135. VERIFY(property_name.is_valid());
  136. // 3. Let success be ? CreateDataProperty(O, P, V).
  137. auto success = TRY(create_data_property(property_name, value));
  138. // 4. If success is false, throw a TypeError exception.
  139. if (!success) {
  140. // FIXME: Improve/contextualize error message
  141. return vm.throw_completion<TypeError>(global_object(), ErrorType::ObjectDefineOwnPropertyReturnedFalse);
  142. }
  143. // 5. Return success.
  144. return success;
  145. }
  146. // 7.3.6 CreateNonEnumerableDataPropertyOrThrow ( O, P, V ), https://tc39.es/proposal-error-cause/#sec-createnonenumerabledatapropertyorthrow
  147. bool Object::create_non_enumerable_data_property_or_throw(PropertyName const& property_name, Value value)
  148. {
  149. VERIFY(!value.is_empty());
  150. VERIFY(property_name.is_valid());
  151. // 1. Let newDesc be the PropertyDescriptor { [[Value]]: V, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true }.
  152. auto new_description = PropertyDescriptor { .value = value, .writable = true, .enumerable = false, .configurable = true };
  153. // 2. Return ? DefinePropertyOrThrow(O, P, newDesc).
  154. return define_property_or_throw(property_name, new_description);
  155. }
  156. // 7.3.8 DefinePropertyOrThrow ( O, P, desc ), https://tc39.es/ecma262/#sec-definepropertyorthrow
  157. bool Object::define_property_or_throw(PropertyName const& property_name, PropertyDescriptor const& property_descriptor)
  158. {
  159. auto& vm = this->vm();
  160. // 1. Assert: Type(O) is Object.
  161. // 2. Assert: IsPropertyKey(P) is true.
  162. VERIFY(property_name.is_valid());
  163. // 3. Let success be ? O.[[DefineOwnProperty]](P, desc).
  164. auto success = TRY_OR_DISCARD(internal_define_own_property(property_name, property_descriptor));
  165. // 4. If success is false, throw a TypeError exception.
  166. if (!success) {
  167. // FIXME: Improve/contextualize error message
  168. vm.throw_exception<TypeError>(global_object(), ErrorType::ObjectDefineOwnPropertyReturnedFalse);
  169. return {};
  170. }
  171. // 5. Return success.
  172. return success;
  173. }
  174. // 7.3.9 DeletePropertyOrThrow ( O, P ), https://tc39.es/ecma262/#sec-deletepropertyorthrow
  175. bool Object::delete_property_or_throw(PropertyName const& property_name)
  176. {
  177. auto& vm = this->vm();
  178. // 1. Assert: Type(O) is Object.
  179. // 2. Assert: IsPropertyKey(P) is true.
  180. VERIFY(property_name.is_valid());
  181. // 3. Let success be ? O.[[Delete]](P).
  182. auto success = TRY_OR_DISCARD(internal_delete(property_name));
  183. // 4. If success is false, throw a TypeError exception.
  184. if (!success) {
  185. // FIXME: Improve/contextualize error message
  186. vm.throw_exception<TypeError>(global_object(), ErrorType::ObjectDeleteReturnedFalse);
  187. return {};
  188. }
  189. // 5. Return success.
  190. return success;
  191. }
  192. // 7.3.11 HasProperty ( O, P ), https://tc39.es/ecma262/#sec-hasproperty
  193. bool Object::has_property(PropertyName const& property_name) const
  194. {
  195. // 1. Assert: Type(O) is Object.
  196. // 2. Assert: IsPropertyKey(P) is true.
  197. VERIFY(property_name.is_valid());
  198. // 3. Return ? O.[[HasProperty]](P).
  199. return TRY_OR_DISCARD(internal_has_property(property_name));
  200. }
  201. // 7.3.12 HasOwnProperty ( O, P ), https://tc39.es/ecma262/#sec-hasownproperty
  202. bool Object::has_own_property(PropertyName const& property_name) const
  203. {
  204. // 1. Assert: Type(O) is Object.
  205. // 2. Assert: IsPropertyKey(P) is true.
  206. VERIFY(property_name.is_valid());
  207. // 3. Let desc be ? O.[[GetOwnProperty]](P).
  208. auto descriptor = TRY_OR_DISCARD(internal_get_own_property(property_name));
  209. // 4. If desc is undefined, return false.
  210. if (!descriptor.has_value())
  211. return false;
  212. // 5. Return true.
  213. return true;
  214. }
  215. // 7.3.15 SetIntegrityLevel ( O, level ), https://tc39.es/ecma262/#sec-setintegritylevel
  216. bool Object::set_integrity_level(IntegrityLevel level)
  217. {
  218. auto& vm = this->vm();
  219. auto& global_object = this->global_object();
  220. // 1. Assert: Type(O) is Object.
  221. // 2. Assert: level is either sealed or frozen.
  222. VERIFY(level == IntegrityLevel::Sealed || level == IntegrityLevel::Frozen);
  223. // 3. Let status be ? O.[[PreventExtensions]]().
  224. auto status = TRY_OR_DISCARD(internal_prevent_extensions());
  225. // 4. If status is false, return false.
  226. if (!status)
  227. return false;
  228. // 5. Let keys be ? O.[[OwnPropertyKeys]]().
  229. auto keys = TRY_OR_DISCARD(internal_own_property_keys());
  230. // 6. If level is sealed, then
  231. if (level == IntegrityLevel::Sealed) {
  232. // a. For each element k of keys, do
  233. for (auto& key : keys) {
  234. auto property_name = PropertyName::from_value(global_object, key);
  235. // i. Perform ? DefinePropertyOrThrow(O, k, PropertyDescriptor { [[Configurable]]: false }).
  236. define_property_or_throw(property_name, { .configurable = false });
  237. if (vm.exception())
  238. return {};
  239. }
  240. }
  241. // 7. Else,
  242. else {
  243. // a. Assert: level is frozen.
  244. // b. For each element k of keys, do
  245. for (auto& key : keys) {
  246. auto property_name = PropertyName::from_value(global_object, key);
  247. // i. Let currentDesc be ? O.[[GetOwnProperty]](k).
  248. auto current_descriptor = TRY_OR_DISCARD(internal_get_own_property(property_name));
  249. // ii. If currentDesc is not undefined, then
  250. if (!current_descriptor.has_value())
  251. continue;
  252. PropertyDescriptor descriptor;
  253. // 1. If IsAccessorDescriptor(currentDesc) is true, then
  254. if (current_descriptor->is_accessor_descriptor()) {
  255. // a. Let desc be the PropertyDescriptor { [[Configurable]]: false }.
  256. descriptor = { .configurable = false };
  257. }
  258. // 2. Else,
  259. else {
  260. // a. Let desc be the PropertyDescriptor { [[Configurable]]: false, [[Writable]]: false }.
  261. descriptor = { .writable = false, .configurable = false };
  262. }
  263. // 3. Perform ? DefinePropertyOrThrow(O, k, desc).
  264. define_property_or_throw(property_name, descriptor);
  265. if (vm.exception())
  266. return {};
  267. }
  268. }
  269. // 8. Return true.
  270. return true;
  271. }
  272. // 7.3.16 TestIntegrityLevel ( O, level ), https://tc39.es/ecma262/#sec-testintegritylevel
  273. bool Object::test_integrity_level(IntegrityLevel level) const
  274. {
  275. // 1. Assert: Type(O) is Object.
  276. // 2. Assert: level is either sealed or frozen.
  277. VERIFY(level == IntegrityLevel::Sealed || level == IntegrityLevel::Frozen);
  278. // 3. Let extensible be ? IsExtensible(O).
  279. auto extensible = TRY_OR_DISCARD(is_extensible());
  280. // 4. If extensible is true, return false.
  281. // 5. NOTE: If the object is extensible, none of its properties are examined.
  282. if (extensible)
  283. return false;
  284. // 6. Let keys be ? O.[[OwnPropertyKeys]]().
  285. auto keys = TRY_OR_DISCARD(internal_own_property_keys());
  286. // 7. For each element k of keys, do
  287. for (auto& key : keys) {
  288. auto property_name = PropertyName::from_value(global_object(), key);
  289. // a. Let currentDesc be ? O.[[GetOwnProperty]](k).
  290. auto current_descriptor = TRY_OR_DISCARD(internal_get_own_property(property_name));
  291. // b. If currentDesc is not undefined, then
  292. if (!current_descriptor.has_value())
  293. continue;
  294. // i. If currentDesc.[[Configurable]] is true, return false.
  295. if (*current_descriptor->configurable)
  296. return false;
  297. // ii. If level is frozen and IsDataDescriptor(currentDesc) is true, then
  298. if (level == IntegrityLevel::Frozen && current_descriptor->is_data_descriptor()) {
  299. // 1. If currentDesc.[[Writable]] is true, return false.
  300. if (*current_descriptor->writable)
  301. return false;
  302. }
  303. }
  304. // 8. Return true.
  305. return true;
  306. }
  307. // 7.3.23 EnumerableOwnPropertyNames ( O, kind ), https://tc39.es/ecma262/#sec-enumerableownpropertynames
  308. MarkedValueList Object::enumerable_own_property_names(PropertyKind kind) const
  309. {
  310. // NOTE: This has been flattened for readability, so some `else` branches in the
  311. // spec text have been replaced with `continue`s in the loop below.
  312. auto& global_object = this->global_object();
  313. // 1. Assert: Type(O) is Object.
  314. // 2. Let ownKeys be ? O.[[OwnPropertyKeys]]().
  315. auto own_keys_or_error = internal_own_property_keys();
  316. if (own_keys_or_error.is_error())
  317. return MarkedValueList { heap() };
  318. auto own_keys = own_keys_or_error.release_value();
  319. // 3. Let properties be a new empty List.
  320. auto properties = MarkedValueList { heap() };
  321. // 4. For each element key of ownKeys, do
  322. for (auto& key : own_keys) {
  323. // a. If Type(key) is String, then
  324. if (!key.is_string())
  325. continue;
  326. auto property_name = PropertyName::from_value(global_object, key);
  327. // i. Let desc be ? O.[[GetOwnProperty]](key).
  328. auto descriptor_or_error = internal_get_own_property(property_name);
  329. if (descriptor_or_error.is_error())
  330. return MarkedValueList { heap() };
  331. auto descriptor = descriptor_or_error.release_value();
  332. // ii. If desc is not undefined and desc.[[Enumerable]] is true, then
  333. if (descriptor.has_value() && *descriptor->enumerable) {
  334. // 1. If kind is key, append key to properties.
  335. if (kind == PropertyKind::Key) {
  336. properties.append(key);
  337. continue;
  338. }
  339. // 2. Else,
  340. // a. Let value be ? Get(O, key).
  341. auto value_or_error = get(property_name);
  342. if (value_or_error.is_error())
  343. return MarkedValueList { heap() };
  344. auto value = value_or_error.release_value();
  345. // b. If kind is value, append value to properties.
  346. if (kind == PropertyKind::Value) {
  347. properties.append(value);
  348. continue;
  349. }
  350. // c. Else,
  351. // i. Assert: kind is key+value.
  352. VERIFY(kind == PropertyKind::KeyAndValue);
  353. // ii. Let entry be ! CreateArrayFromList(« key, value »).
  354. auto entry = Array::create_from(global_object, { key, value });
  355. // iii. Append entry to properties.
  356. properties.append(entry);
  357. }
  358. }
  359. // 5. Return properties.
  360. return properties;
  361. }
  362. // 7.3.25 CopyDataProperties ( target, source, excludedItems ), https://tc39.es/ecma262/#sec-copydataproperties
  363. ThrowCompletionOr<Object*> Object::copy_data_properties(Value source, HashTable<PropertyName, PropertyNameTraits> const& seen_names, GlobalObject& global_object)
  364. {
  365. if (source.is_nullish())
  366. return this;
  367. auto* from_object = source.to_object(global_object);
  368. VERIFY(from_object);
  369. for (auto& next_key_value : TRY(from_object->internal_own_property_keys())) {
  370. auto next_key = PropertyName::from_value(global_object, next_key_value);
  371. if (seen_names.contains(next_key))
  372. continue;
  373. auto desc = TRY(from_object->internal_get_own_property(next_key));
  374. if (desc.has_value() && desc->attributes().is_enumerable()) {
  375. auto prop_value = TRY(from_object->get(next_key));
  376. TRY(create_data_property_or_throw(next_key, prop_value));
  377. }
  378. }
  379. return this;
  380. }
  381. // 10.1 Ordinary Object Internal Methods and Internal Slots, https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots
  382. // 10.1.1 [[GetPrototypeOf]] ( ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-getprototypeof
  383. ThrowCompletionOr<Object*> Object::internal_get_prototype_of() const
  384. {
  385. // 1. Return O.[[Prototype]].
  386. return const_cast<Object*>(prototype());
  387. }
  388. // 10.1.2 [[SetPrototypeOf]] ( V ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-setprototypeof-v
  389. ThrowCompletionOr<bool> Object::internal_set_prototype_of(Object* new_prototype)
  390. {
  391. // 1. Assert: Either Type(V) is Object or Type(V) is Null.
  392. // 2. Let current be O.[[Prototype]].
  393. // 3. If SameValue(V, current) is true, return true.
  394. if (prototype() == new_prototype)
  395. return true;
  396. // 4. Let extensible be O.[[Extensible]].
  397. // 5. If extensible is false, return false.
  398. if (!m_is_extensible)
  399. return false;
  400. // 6. Let p be V.
  401. auto* prototype = new_prototype;
  402. // 7. Let done be false.
  403. // 8. Repeat, while done is false,
  404. while (prototype) {
  405. // a. If p is null, set done to true.
  406. // b. Else if SameValue(p, O) is true, return false.
  407. if (prototype == this)
  408. return false;
  409. // c. Else,
  410. // i. If p.[[GetPrototypeOf]] is not the ordinary object internal method defined in 10.1.1, set done to true.
  411. // NOTE: This is a best-effort implementation; we don't have a good way of detecting whether certain virtual
  412. // Object methods have been overridden by a given object, but as ProxyObject is the only one doing that for
  413. // [[SetPrototypeOf]], this check does the trick.
  414. if (is<ProxyObject>(prototype))
  415. break;
  416. // ii. Else, set p to p.[[Prototype]].
  417. prototype = prototype->prototype();
  418. }
  419. // 9. Set O.[[Prototype]] to V.
  420. set_prototype(new_prototype);
  421. // 10. Return true.
  422. return true;
  423. }
  424. // 10.1.3 [[IsExtensible]] ( ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-isextensible
  425. ThrowCompletionOr<bool> Object::internal_is_extensible() const
  426. {
  427. // 1. Return O.[[Extensible]].
  428. return m_is_extensible;
  429. }
  430. // 10.1.4 [[PreventExtensions]] ( ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-preventextensions
  431. ThrowCompletionOr<bool> Object::internal_prevent_extensions()
  432. {
  433. // 1. Set O.[[Extensible]] to false.
  434. m_is_extensible = false;
  435. // 2. Return true.
  436. return true;
  437. }
  438. // 10.1.5 [[GetOwnProperty]] ( P ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-getownproperty-p
  439. ThrowCompletionOr<Optional<PropertyDescriptor>> Object::internal_get_own_property(PropertyName const& property_name) const
  440. {
  441. // 1. Assert: IsPropertyKey(P) is true.
  442. VERIFY(property_name.is_valid());
  443. // 2. If O does not have an own property with key P, return undefined.
  444. if (!storage_has(property_name))
  445. return Optional<PropertyDescriptor> {};
  446. // 3. Let D be a newly created Property Descriptor with no fields.
  447. PropertyDescriptor descriptor;
  448. // 4. Let X be O's own property whose key is P.
  449. auto [value, attributes] = *storage_get(property_name);
  450. // 5. If X is a data property, then
  451. if (!value.is_accessor()) {
  452. // a. Set D.[[Value]] to the value of X's [[Value]] attribute.
  453. descriptor.value = value.value_or(js_undefined());
  454. // b. Set D.[[Writable]] to the value of X's [[Writable]] attribute.
  455. descriptor.writable = attributes.is_writable();
  456. }
  457. // 6. Else,
  458. else {
  459. // a. Assert: X is an accessor property.
  460. // b. Set D.[[Get]] to the value of X's [[Get]] attribute.
  461. descriptor.get = value.as_accessor().getter();
  462. // c. Set D.[[Set]] to the value of X's [[Set]] attribute.
  463. descriptor.set = value.as_accessor().setter();
  464. }
  465. // 7. Set D.[[Enumerable]] to the value of X's [[Enumerable]] attribute.
  466. descriptor.enumerable = attributes.is_enumerable();
  467. // 8. Set D.[[Configurable]] to the value of X's [[Configurable]] attribute.
  468. descriptor.configurable = attributes.is_configurable();
  469. // 9. Return D.
  470. return { descriptor };
  471. }
  472. // 10.1.6 [[DefineOwnProperty]] ( P, Desc ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-defineownproperty-p-desc
  473. ThrowCompletionOr<bool> Object::internal_define_own_property(PropertyName const& property_name, PropertyDescriptor const& property_descriptor)
  474. {
  475. VERIFY(property_name.is_valid());
  476. // 1. Let current be ? O.[[GetOwnProperty]](P).
  477. auto current = TRY(internal_get_own_property(property_name));
  478. // 2. Let extensible be ? IsExtensible(O).
  479. auto extensible = TRY(is_extensible());
  480. // 3. Return ValidateAndApplyPropertyDescriptor(O, P, extensible, Desc, current).
  481. return validate_and_apply_property_descriptor(this, property_name, extensible, property_descriptor, current);
  482. }
  483. // 10.1.7 [[HasProperty]] ( P ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-hasproperty-p
  484. ThrowCompletionOr<bool> Object::internal_has_property(PropertyName const& property_name) const
  485. {
  486. auto& vm = this->vm();
  487. // 1. Assert: IsPropertyKey(P) is true.
  488. VERIFY(property_name.is_valid());
  489. // 2. Let hasOwn be ? O.[[GetOwnProperty]](P).
  490. auto has_own = TRY(internal_get_own_property(property_name));
  491. // 3. If hasOwn is not undefined, return true.
  492. if (has_own.has_value())
  493. return true;
  494. // 4. Let parent be ? O.[[GetPrototypeOf]]().
  495. auto* parent = TRY(internal_get_prototype_of());
  496. // 5. If parent is not null, then
  497. if (parent) {
  498. // a. Return ? parent.[[HasProperty]](P).
  499. auto result = parent->internal_has_property(property_name);
  500. if (auto* exception = vm.exception())
  501. return throw_completion(exception->value());
  502. return result;
  503. }
  504. // 6. Return false.
  505. return false;
  506. }
  507. // 10.1.8 [[Get]] ( P, Receiver ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-get-p-receiver
  508. ThrowCompletionOr<Value> Object::internal_get(PropertyName const& property_name, Value receiver) const
  509. {
  510. VERIFY(!receiver.is_empty());
  511. auto& vm = this->vm();
  512. // 1. Assert: IsPropertyKey(P) is true.
  513. VERIFY(property_name.is_valid());
  514. // 2. Let desc be ? O.[[GetOwnProperty]](P).
  515. auto descriptor = TRY(internal_get_own_property(property_name));
  516. // 3. If desc is undefined, then
  517. if (!descriptor.has_value()) {
  518. // a. Let parent be ? O.[[GetPrototypeOf]]().
  519. auto* parent = TRY(internal_get_prototype_of());
  520. // b. If parent is null, return undefined.
  521. if (!parent)
  522. return js_undefined();
  523. // c. Return ? parent.[[Get]](P, Receiver).
  524. return parent->internal_get(property_name, receiver);
  525. }
  526. // 4. If IsDataDescriptor(desc) is true, return desc.[[Value]].
  527. if (descriptor->is_data_descriptor())
  528. return *descriptor->value;
  529. // 5. Assert: IsAccessorDescriptor(desc) is true.
  530. VERIFY(descriptor->is_accessor_descriptor());
  531. // 6. Let getter be desc.[[Get]].
  532. auto* getter = *descriptor->get;
  533. // 7. If getter is undefined, return undefined.
  534. if (!getter)
  535. return js_undefined();
  536. // 8. Return ? Call(getter, Receiver).
  537. return TRY(vm.call(*getter, receiver));
  538. }
  539. // 10.1.9 [[Set]] ( P, V, Receiver ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-set-p-v-receiver
  540. ThrowCompletionOr<bool> Object::internal_set(PropertyName const& property_name, Value value, Value receiver)
  541. {
  542. VERIFY(!value.is_empty());
  543. VERIFY(!receiver.is_empty());
  544. auto& vm = this->vm();
  545. // 1. Assert: IsPropertyKey(P) is true.
  546. VERIFY(property_name.is_valid());
  547. // 2. Let ownDesc be ? O.[[GetOwnProperty]](P).
  548. auto own_descriptor = TRY(internal_get_own_property(property_name));
  549. // 3. Return OrdinarySetWithOwnDescriptor(O, P, V, Receiver, ownDesc).
  550. auto success = ordinary_set_with_own_descriptor(property_name, value, receiver, own_descriptor);
  551. if (auto* exception = vm.exception())
  552. return throw_completion(exception->value());
  553. return success;
  554. }
  555. // 10.1.9.2 OrdinarySetWithOwnDescriptor ( O, P, V, Receiver, ownDesc ), https://tc39.es/ecma262/#sec-ordinarysetwithowndescriptor
  556. bool Object::ordinary_set_with_own_descriptor(PropertyName const& property_name, Value value, Value receiver, Optional<PropertyDescriptor> own_descriptor)
  557. {
  558. auto& vm = this->vm();
  559. // 1. Assert: IsPropertyKey(P) is true.
  560. VERIFY(property_name.is_valid());
  561. // 2. If ownDesc is undefined, then
  562. if (!own_descriptor.has_value()) {
  563. // a. Let parent be ? O.[[GetPrototypeOf]]().
  564. auto* parent = TRY_OR_DISCARD(internal_get_prototype_of());
  565. // b. If parent is not null, then
  566. if (parent) {
  567. // i. Return ? parent.[[Set]](P, V, Receiver).
  568. return TRY_OR_DISCARD(parent->internal_set(property_name, value, receiver));
  569. }
  570. // c. Else,
  571. else {
  572. // i. Set ownDesc to the PropertyDescriptor { [[Value]]: undefined, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: true }.
  573. own_descriptor = PropertyDescriptor {
  574. .value = js_undefined(),
  575. .writable = true,
  576. .enumerable = true,
  577. .configurable = true,
  578. };
  579. }
  580. }
  581. // 3. If IsDataDescriptor(ownDesc) is true, then
  582. if (own_descriptor->is_data_descriptor()) {
  583. // a. If ownDesc.[[Writable]] is false, return false.
  584. if (!*own_descriptor->writable)
  585. return false;
  586. // b. If Type(Receiver) is not Object, return false.
  587. if (!receiver.is_object())
  588. return false;
  589. // c. Let existingDescriptor be ? Receiver.[[GetOwnProperty]](P).
  590. auto existing_descriptor = TRY_OR_DISCARD(receiver.as_object().internal_get_own_property(property_name));
  591. // d. If existingDescriptor is not undefined, then
  592. if (existing_descriptor.has_value()) {
  593. // i. If IsAccessorDescriptor(existingDescriptor) is true, return false.
  594. if (existing_descriptor->is_accessor_descriptor())
  595. return false;
  596. // ii. If existingDescriptor.[[Writable]] is false, return false.
  597. if (!*existing_descriptor->writable)
  598. return false;
  599. // iii. Let valueDesc be the PropertyDescriptor { [[Value]]: V }.
  600. auto value_descriptor = PropertyDescriptor { .value = value };
  601. // iv. Return ? Receiver.[[DefineOwnProperty]](P, valueDesc).
  602. return TRY_OR_DISCARD(receiver.as_object().internal_define_own_property(property_name, value_descriptor));
  603. }
  604. // e. Else,
  605. else {
  606. // i. Assert: Receiver does not currently have a property P.
  607. VERIFY(!receiver.as_object().storage_has(property_name));
  608. // ii. Return ? CreateDataProperty(Receiver, P, V).
  609. return TRY_OR_DISCARD(receiver.as_object().create_data_property(property_name, value));
  610. }
  611. }
  612. // 4. Assert: IsAccessorDescriptor(ownDesc) is true.
  613. VERIFY(own_descriptor->is_accessor_descriptor());
  614. // 5. Let setter be ownDesc.[[Set]].
  615. auto* setter = *own_descriptor->set;
  616. // 6. If setter is undefined, return false.
  617. if (!setter)
  618. return false;
  619. // 7. Perform ? Call(setter, Receiver, « V »).
  620. (void)vm.call(*setter, receiver, value);
  621. if (vm.exception())
  622. return {};
  623. // 8. Return true.
  624. return true;
  625. }
  626. // 10.1.10 [[Delete]] ( P ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-delete-p
  627. ThrowCompletionOr<bool> Object::internal_delete(PropertyName const& property_name)
  628. {
  629. // 1. Assert: IsPropertyKey(P) is true.
  630. VERIFY(property_name.is_valid());
  631. // 2. Let desc be ? O.[[GetOwnProperty]](P).
  632. auto descriptor = TRY(internal_get_own_property(property_name));
  633. // 3. If desc is undefined, return true.
  634. if (!descriptor.has_value())
  635. return true;
  636. // 4. If desc.[[Configurable]] is true, then
  637. if (*descriptor->configurable) {
  638. // a. Remove the own property with name P from O.
  639. storage_delete(property_name);
  640. // b. Return true.
  641. return true;
  642. }
  643. // 5. Return false.
  644. return false;
  645. }
  646. // 10.1.11 [[OwnPropertyKeys]] ( ), https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots-ownpropertykeys
  647. ThrowCompletionOr<MarkedValueList> Object::internal_own_property_keys() const
  648. {
  649. auto& vm = this->vm();
  650. // 1. Let keys be a new empty List.
  651. MarkedValueList keys { heap() };
  652. // 2. For each own property key P of O such that P is an array index, in ascending numeric index order, do
  653. for (auto& entry : m_indexed_properties) {
  654. // a. Add P as the last element of keys.
  655. keys.append(js_string(vm, String::number(entry.index())));
  656. }
  657. // 3. For each own property key P of O such that Type(P) is String and P is not an array index, in ascending chronological order of property creation, do
  658. for (auto& it : shape().property_table_ordered()) {
  659. if (it.key.is_string()) {
  660. // a. Add P as the last element of keys.
  661. keys.append(it.key.to_value(vm));
  662. }
  663. }
  664. // 4. For each own property key P of O such that Type(P) is Symbol, in ascending chronological order of property creation, do
  665. for (auto& it : shape().property_table_ordered()) {
  666. if (it.key.is_symbol()) {
  667. // a. Add P as the last element of keys.
  668. keys.append(it.key.to_value(vm));
  669. }
  670. }
  671. // 5. Return keys.
  672. return { move(keys) };
  673. }
  674. // 10.4.7.2 SetImmutablePrototype ( O, V ), https://tc39.es/ecma262/#sec-set-immutable-prototype
  675. bool Object::set_immutable_prototype(Object* prototype)
  676. {
  677. // 1. Assert: Either Type(V) is Object or Type(V) is Null.
  678. // 2. Let current be ? O.[[GetPrototypeOf]]().
  679. auto* current = TRY_OR_DISCARD(internal_get_prototype_of());
  680. // 3. If SameValue(V, current) is true, return true.
  681. if (prototype == current)
  682. return true;
  683. // 4. Return false.
  684. return false;
  685. }
  686. Optional<ValueAndAttributes> Object::storage_get(PropertyName const& property_name) const
  687. {
  688. VERIFY(property_name.is_valid());
  689. Value value;
  690. PropertyAttributes attributes;
  691. if (property_name.is_number()) {
  692. auto value_and_attributes = m_indexed_properties.get(property_name.as_number());
  693. if (!value_and_attributes.has_value())
  694. return {};
  695. value = value_and_attributes->value;
  696. attributes = value_and_attributes->attributes;
  697. } else {
  698. auto metadata = shape().lookup(property_name.to_string_or_symbol());
  699. if (!metadata.has_value())
  700. return {};
  701. value = m_storage[metadata->offset];
  702. attributes = metadata->attributes;
  703. }
  704. return ValueAndAttributes { .value = value, .attributes = attributes };
  705. }
  706. bool Object::storage_has(PropertyName const& property_name) const
  707. {
  708. VERIFY(property_name.is_valid());
  709. if (property_name.is_number())
  710. return m_indexed_properties.has_index(property_name.as_number());
  711. return shape().lookup(property_name.to_string_or_symbol()).has_value();
  712. }
  713. void Object::storage_set(PropertyName const& property_name, ValueAndAttributes const& value_and_attributes)
  714. {
  715. VERIFY(property_name.is_valid());
  716. auto [value, attributes] = value_and_attributes;
  717. if (property_name.is_number()) {
  718. auto index = property_name.as_number();
  719. m_indexed_properties.put(index, value, attributes);
  720. return;
  721. }
  722. auto property_name_string_or_symbol = property_name.to_string_or_symbol();
  723. auto metadata = shape().lookup(property_name_string_or_symbol);
  724. if (!metadata.has_value()) {
  725. if (!m_shape->is_unique() && shape().property_count() > 100) {
  726. // If you add more than 100 properties to an object, let's stop doing
  727. // transitions to avoid filling up the heap with shapes.
  728. ensure_shape_is_unique();
  729. }
  730. if (m_shape->is_unique())
  731. m_shape->add_property_to_unique_shape(property_name_string_or_symbol, attributes);
  732. else
  733. set_shape(*m_shape->create_put_transition(property_name_string_or_symbol, attributes));
  734. m_storage.append(value);
  735. return;
  736. }
  737. if (attributes != metadata->attributes) {
  738. if (m_shape->is_unique())
  739. m_shape->reconfigure_property_in_unique_shape(property_name_string_or_symbol, attributes);
  740. else
  741. set_shape(*m_shape->create_configure_transition(property_name_string_or_symbol, attributes));
  742. }
  743. m_storage[metadata->offset] = value;
  744. }
  745. void Object::storage_delete(PropertyName const& property_name)
  746. {
  747. VERIFY(property_name.is_valid());
  748. VERIFY(storage_has(property_name));
  749. if (property_name.is_number())
  750. return m_indexed_properties.remove(property_name.as_number());
  751. auto metadata = shape().lookup(property_name.to_string_or_symbol());
  752. VERIFY(metadata.has_value());
  753. ensure_shape_is_unique();
  754. shape().remove_property_from_unique_shape(property_name.to_string_or_symbol(), metadata->offset);
  755. m_storage.remove(metadata->offset);
  756. }
  757. void Object::set_prototype(Object* new_prototype)
  758. {
  759. if (prototype() == new_prototype)
  760. return;
  761. auto& shape = this->shape();
  762. if (shape.is_unique())
  763. shape.set_prototype_without_transition(new_prototype);
  764. else
  765. m_shape = shape.create_prototype_transition(new_prototype);
  766. }
  767. void Object::define_native_accessor(PropertyName const& property_name, Function<Value(VM&, GlobalObject&)> getter, Function<Value(VM&, GlobalObject&)> setter, PropertyAttributes attribute)
  768. {
  769. auto& vm = this->vm();
  770. String formatted_property_name;
  771. if (property_name.is_number()) {
  772. formatted_property_name = property_name.to_string();
  773. } else if (property_name.is_string()) {
  774. formatted_property_name = property_name.as_string();
  775. } else {
  776. formatted_property_name = String::formatted("[{}]", property_name.as_symbol()->description());
  777. }
  778. FunctionObject* getter_function = nullptr;
  779. if (getter) {
  780. auto name = String::formatted("get {}", formatted_property_name);
  781. getter_function = NativeFunction::create(global_object(), name, move(getter));
  782. getter_function->define_direct_property(vm.names.length, Value(0), Attribute::Configurable);
  783. getter_function->define_direct_property(vm.names.name, js_string(vm, name), Attribute::Configurable);
  784. }
  785. FunctionObject* setter_function = nullptr;
  786. if (setter) {
  787. auto name = String::formatted("set {}", formatted_property_name);
  788. setter_function = NativeFunction::create(global_object(), name, move(setter));
  789. setter_function->define_direct_property(vm.names.length, Value(1), Attribute::Configurable);
  790. setter_function->define_direct_property(vm.names.name, js_string(vm, name), Attribute::Configurable);
  791. }
  792. return define_direct_accessor(property_name, getter_function, setter_function, attribute);
  793. }
  794. void Object::define_direct_accessor(PropertyName const& property_name, FunctionObject* getter, FunctionObject* setter, PropertyAttributes attributes)
  795. {
  796. VERIFY(property_name.is_valid());
  797. auto existing_property = storage_get(property_name).value_or({}).value;
  798. auto* accessor = existing_property.is_accessor() ? &existing_property.as_accessor() : nullptr;
  799. if (!accessor) {
  800. accessor = Accessor::create(vm(), getter, setter);
  801. define_direct_property(property_name, accessor, attributes);
  802. } else {
  803. if (getter)
  804. accessor->set_getter(getter);
  805. if (setter)
  806. accessor->set_setter(setter);
  807. }
  808. }
  809. void Object::ensure_shape_is_unique()
  810. {
  811. if (shape().is_unique())
  812. return;
  813. m_shape = m_shape->create_unique_clone();
  814. }
  815. // Simple side-effect free property lookup, following the prototype chain. Non-standard.
  816. Value Object::get_without_side_effects(const PropertyName& property_name) const
  817. {
  818. auto* object = this;
  819. while (object) {
  820. auto value_and_attributes = object->storage_get(property_name);
  821. if (value_and_attributes.has_value())
  822. return value_and_attributes->value;
  823. object = object->prototype();
  824. }
  825. return {};
  826. }
  827. void Object::define_native_function(PropertyName const& property_name, Function<Value(VM&, GlobalObject&)> native_function, i32 length, PropertyAttributes attribute)
  828. {
  829. auto& vm = this->vm();
  830. String function_name;
  831. if (property_name.is_string()) {
  832. function_name = property_name.as_string();
  833. } else {
  834. function_name = String::formatted("[{}]", property_name.as_symbol()->description());
  835. }
  836. auto* function = NativeFunction::create(global_object(), function_name, move(native_function));
  837. function->define_direct_property(vm.names.length, Value(length), Attribute::Configurable);
  838. function->define_direct_property(vm.names.name, js_string(vm, function_name), Attribute::Configurable);
  839. define_direct_property(property_name, function, attribute);
  840. }
  841. // 20.1.2.3.1 ObjectDefineProperties ( O, Properties ), https://tc39.es/ecma262/#sec-objectdefineproperties
  842. Object* Object::define_properties(Value properties)
  843. {
  844. auto& vm = this->vm();
  845. auto& global_object = this->global_object();
  846. // 1. Assert: Type(O) is Object.
  847. // 2. Let props be ? ToObject(Properties).
  848. auto* props = properties.to_object(global_object);
  849. if (vm.exception())
  850. return {};
  851. // 3. Let keys be ? props.[[OwnPropertyKeys]]().
  852. auto keys = TRY_OR_DISCARD(props->internal_own_property_keys());
  853. struct NameAndDescriptor {
  854. PropertyName name;
  855. PropertyDescriptor descriptor;
  856. };
  857. // 4. Let descriptors be a new empty List.
  858. Vector<NameAndDescriptor> descriptors;
  859. // 5. For each element nextKey of keys, do
  860. for (auto& next_key : keys) {
  861. auto property_name = PropertyName::from_value(global_object, next_key);
  862. // a. Let propDesc be ? props.[[GetOwnProperty]](nextKey).
  863. auto property_descriptor = TRY_OR_DISCARD(props->internal_get_own_property(property_name));
  864. // b. If propDesc is not undefined and propDesc.[[Enumerable]] is true, then
  865. if (property_descriptor.has_value() && *property_descriptor->enumerable) {
  866. // i. Let descObj be ? Get(props, nextKey).
  867. auto descriptor_object = TRY_OR_DISCARD(props->get(property_name));
  868. // ii. Let desc be ? ToPropertyDescriptor(descObj).
  869. auto descriptor = to_property_descriptor(global_object, descriptor_object);
  870. if (vm.exception())
  871. return {};
  872. // iii. Append the pair (a two element List) consisting of nextKey and desc to the end of descriptors.
  873. descriptors.append({ property_name, descriptor });
  874. }
  875. }
  876. // 6. For each element pair of descriptors, do
  877. for (auto& [name, descriptor] : descriptors) {
  878. // a. Let P be the first element of pair.
  879. // b. Let desc be the second element of pair.
  880. // c. Perform ? DefinePropertyOrThrow(O, P, desc).
  881. define_property_or_throw(name, descriptor);
  882. if (vm.exception())
  883. return {};
  884. }
  885. // 7. Return O.
  886. return this;
  887. }
  888. void Object::visit_edges(Cell::Visitor& visitor)
  889. {
  890. Cell::visit_edges(visitor);
  891. visitor.visit(m_shape);
  892. for (auto& value : m_storage)
  893. visitor.visit(value);
  894. m_indexed_properties.for_each_value([&visitor](auto& value) {
  895. visitor.visit(value);
  896. });
  897. }
  898. // 7.1.1.1 OrdinaryToPrimitive ( O, hint ), https://tc39.es/ecma262/#sec-ordinarytoprimitive
  899. ThrowCompletionOr<Value> Object::ordinary_to_primitive(Value::PreferredType preferred_type) const
  900. {
  901. VERIFY(preferred_type == Value::PreferredType::String || preferred_type == Value::PreferredType::Number);
  902. auto& vm = this->vm();
  903. AK::Array<PropertyName, 2> method_names;
  904. // 1. If hint is string, then
  905. if (preferred_type == Value::PreferredType::String) {
  906. // a. Let methodNames be « "toString", "valueOf" ».
  907. method_names = { vm.names.toString, vm.names.valueOf };
  908. } else {
  909. // a. Let methodNames be « "valueOf", "toString" ».
  910. method_names = { vm.names.valueOf, vm.names.toString };
  911. }
  912. // 3. For each element name of methodNames, do
  913. for (auto& method_name : method_names) {
  914. // a. Let method be ? Get(O, name).
  915. auto method = TRY(get(method_name));
  916. // b. If IsCallable(method) is true, then
  917. if (method.is_function()) {
  918. // i. Let result be ? Call(method, O).
  919. auto result = TRY(vm.call(method.as_function(), const_cast<Object*>(this)));
  920. // ii. If Type(result) is not Object, return result.
  921. if (!result.is_object())
  922. return result;
  923. }
  924. }
  925. // 4. Throw a TypeError exception.
  926. return vm.throw_completion<TypeError>(global_object(), ErrorType::Convert, "object", preferred_type == Value::PreferredType::String ? "string" : "number");
  927. }
  928. }