عرض مصدر JavaScript/Object/preventExtensions

<noinclude>{{DISPLAYTITLE:<code>Object.preventExtensions()‎</code>}}</noinclude>
الدالة <code>Object.preventExtensions()‎</code> تمنع إضافة خاصيات جديدة إلى الكائن.

== البنية العامة ==
<syntaxhighlight lang="javascript">
Object.preventExtensions(obj)

</syntaxhighlight>

=== <code>obj</code> ===
الكائن الذي نريد منع إضافة خاصيات جديدة إليه.

=== القيمة المعادة ===
الكائن المعني لكن مع جعله لا يقبل خاصيات جديدة.

== الوصف ==
يكون الكائن قابلًا للتوسعة إذا أمكن إضافة خاصيات جديدة إليه، والدالة <code>Object.preventExtensions()‎</code> تجعل الكائن غير قابلٍ للتوسعة، أي أنَّه لن يقبل خاصيات جديدة لم تكن موجودةً فيه في وقت جعله غير قابلٍ للتوسعة.

لاحظ أنَّه عمومًا تكون خاصيات الكائنات غير القابلة للتوسعة قابلةً للحذف (عبر المعامل <code>[[JavaScript/delete|delete]]</code>)، لكن محاولة إضافة خاصيات جديدة إلى كائنٍ غير قابلٍ للتوسعة ستفشل، إما بصمت أو برمي الخطأ <code>[[JavaScript/TypeError|TypeError]]</code> (عادةً عندما تنفيذ الشيفرة في [[JavaScript/Strict Mode|نمط strict]]، لكن هنالك حالات أخرى سيرمى فيها هذا الخطأ).

الدالة <code>Object.preventExtensions()‎</code> تمنع إضافة خاصيات تابعة للكائن مباشرةً، لكن ما يزال بالإمكان إضافة الخاصيات إلى سلسلة prototype للكائن.

لا توجد طريقة لجعل الكائن قابلًا للتوسعة بعد تحويله إلى كائنٍ غير قابلٍ للتوسعة.

لاحظ أنَّه في معيار ECMAScript 5 كان استعمال هذه الدالة على وسيطٍ ليس كائنًا (أي قيمةً أوليةً) سيؤدي إلى رمي <code>[[JavaScript/TypeError|TypeError]]</code>، لكن بدءًا من ECMAScript 2015 (أي ES6) فستُعامل الوسائط التي لا تُمثِّل كائنات على أنها كائنات غير قابلة للتوسعة، وستُعاد كما هي:<syntaxhighlight lang="javascript">
Object.preventExtensions(1);
// TypeError: 1 is not an object (ES5)

Object.preventExtensions(1);
// 1                             (ES2015)

</syntaxhighlight>

== أمثلة ==
لاحظ أنَّ الدالة <code>Object.preventExtensions()‎</code> ستُعيد الكائن الذي حوّلته إلى كائنٍ غيرِ قابلٍ للتوسعة: <syntaxhighlight lang="javascript">
var obj = {};
var obj2 = Object.preventExtensions(obj);
obj === obj2; // true

</syntaxhighlight>تكون الكائنات قابلةً للتوسعة افتراضيًا، وسنختبر ذلك باستخدام الدالة <code>[[JavaScript/Object/isExtensible|Object.isExtensible()‎]]</code>: <syntaxhighlight lang="javascript">
var empty = {};
Object.isExtensible(empty); // === true

// سنجعل الكائن غير قابلٍ للتوسعة
Object.preventExtensions(empty);
Object.isExtensible(empty); // === false

</syntaxhighlight>عند محاولة إضافة خاصية جديدة إلى كائنٍ غير قابلٍ للتوسعة باستخدام الدالة <code>[[JavaScript/Object/defineProperty|Object.defineProperty()‎]]</code>، فسيرمى الخطأ <code>[[JavaScript/TypeError|TypeError]]</code>: <syntaxhighlight lang="javascript">
var nonExtensible = { removable: true };
Object.preventExtensions(nonExtensible);
Object.defineProperty(nonExtensible, 'new', {
  value: 8675309
}); // TypeError: Cannot define property new, object is not extensible

</syntaxhighlight>وكذلك الأمر في [[JavaScript/Strict Mode|نمط strict]]، فالشيفرة الآتية سترمي الخطأ <code>[[JavaScript/TypeError|TypeError]]</code>: <syntaxhighlight lang="javascript">
function fail() {
  'use strict';
  // TypeError: Cannot add property newProperty, object is not extensible
  nonExtensible.newProperty = 'FAIL';
}
fail();

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|6
|4
|9
|12
|5.1
|}
== مصادر ومواصفات ==
*مسودة المعيار [https://tc39.github.io/ecma262/#sec-object.preventextensions ECMAScript Latest Draft].
*معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-object.preventextensions ECMAScript 2015 (6th Edition)]‎.
*معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.2.3.10 ECMAScript 5.1].
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript Object]]