عرض مصدر JavaScript/JSON/parse

<noinclude>{{DISPLAYTITLE:<code>JSON.parse()‎</code>}}</noinclude>
الدالة <code>JSON.parse()‎</code> تُفسِّر سلسلة JSON النصية، وتبني القيمة أو الكائن في JavaScript الموصوف من السلسلة النصية. ويمكن توفير دالة اختيارية لإجراء عملية تحويل على الكائن قبل إعادته.

== البنية العامة ==
<syntaxhighlight lang="javascript">
JSON.parse(text[, reviver])

</syntaxhighlight>

=== <code>text</code> ===
السلسلة النصية التي ستُفسَّر على أنها بصيغة JSON. راجع صفحة الكائن <code>[[JavaScript/JSON|JSON]]</code> لمزيٍد من المعلومات حول هذه الصيغة.

=== <code>reviver</code> ===
الدالة التي تصف كيفية تحويل القيمة المُخزَّنة بصيغة JSON إلى القيمة الأصلية قبل إعادتها.

=== القيمة المعادة ===
كائن <code>[[JavaScript/Object|Object]]</code> يُمثِّل قيمة JSON.

=== الاستثناءات ===
سيرمى الاستثناء <code>[[JavaScript/SyntaxError|SyntaxError]]</code> إذا لم تكن السلسلة النصية بصيغة JSON صالحة.

== أمثلة ==

=== استخدام <code>JSON.parse()‎</code> ===
<syntaxhighlight lang="javascript">
JSON.parse('{}');              // {}
JSON.parse('true');            // true
JSON.parse('"foo"');           // "foo"
JSON.parse('[1, 5, "false"]'); // [1, 5, "false"]
JSON.parse('null');            // null

</syntaxhighlight>

=== استخدام المعامل <code>reviver</code> ===
إذا حُدِّدت قيمة للمعامل <code>reviver</code> فستحوّل القيمة المحسوبة من عملية التفسير قبل إعادته؛ أي أنَّ القيمة المحسوبة وجميع خاصياته ستمر على الدالة <code>reviver</code>، وإذا أعادت الدالة <code>reviver</code> القيمة <code>[[JavaScript/undefined|undefined]]</code> (أو لم تُعد أيّة قيمة) فستُحذَف الخاصية من الكائن، وستُغيّر قيمة الخاصية فيما عدا ذلك من الحالات.

لاحظ أنَّ المثال الآتي يستخدم [[JavaScript/Arrow Functions|الدوال السهمية]]:<syntaxhighlight lang="javascript">
JSON.parse('{"p": 5}', (key, value) =>
  typeof value === 'number'
    ? value * 2 // value * 2 للأرقام
    : value     // إعادة القيمة كما هي لبقية الأنواع
);

// { p: 10 }

JSON.parse('{"1": 1, "2": 2, "3": {"4": 4, "5": {"6": 6}}}', (key, value) => {
  console.log(key); // عرض اسم الخاصية
  return value;     // إعادة القيمة دون تعديل
});

// 1
// 2
// 4
// 6
// 5
// 3 
// ""

</syntaxhighlight>

=== لا تسمح <code>JSON.parse()‎</code> بإضافة فاصلة في النهاية ===
لا يجوز وضع فاصلة بعد آخر خاصية أو عنصر من عناصر المصفوفة، وفعل ذلك سيؤدي إلى رمي الاستثناء <code>[[JavaScript/SyntaxError|SyntaxError]]</code>:<syntaxhighlight lang="javascript">
JSON.parse('[1, 2, 3, 4, ]');
JSON.parse('{"foo" : 1, }');

</syntaxhighlight>

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