JSON سنٹیکس کی عام غلطیاں اور ان کا حل: RFC 8259 معیاری گائیڈ

1. JSON اور RFC 8259 کی ساخت

جاوا اسکرپٹ آبجیکٹ نوٹیشن (JSON) دنیا بھر کے سافٹ ویئر APIs، کنفیگریشن فائلوں اور ڈیٹا بیسز کے مابین ڈیٹا کے تبادلے کا سب سے مقبول فارمیٹ ہے۔ تاہم، جاوا اسکرپٹ کے روایتی آبجیکٹ لٹرلز کے برعکس، JSON کا باضابطہ بین الاقوامی معیار (IETF RFC 8259 اور ECMA-404) سنٹیکس کے حوالے سے انتہائی سخت اور غیر لچکدار ہے۔

ایک چھوٹے سے اضافی کوما یا غلط جگہ پر لگے ہوئے سنگل کوٹ کی وجہ سے پورا سرور کریش ہو سکتا ہے یا JSON.parse() کی ایکسیپشن آ سکتی ہے۔

2. چار سب سے عام JSON سنٹیکس ایررز

الف. آخری کوما (Trailing Comma) کا استعمال

جاوا اسکرپٹ یا پائتھن لسٹس میں آخری آئٹم کے بعد کوما لگانا درست مانا جاتا ہے، لیکن باضابطہ JSON میں یہ ایک سنگین سنٹیکس ایرر ہے:

// غلط JSON:
{
  "name": "Ali",
  "status": "active",  <-- یہ کوما سنٹیکس توڑ رہا ہے
}

// درست JSON:
{
  "name": "Ali",
  "status": "active"
}

ب. سنگل کوٹس بمقابلہ ڈبل کوٹس (Single vs. Double Quotes)

JSON معیار کے مطابق تمام اسٹرنگز اور ڈکشنری کیز کا ڈبل کوٹس (") میں بند ہونا لازمی ہے۔ سنگل کوٹس (') قطعی طور پر ممنوع ہیں:

// غلط:
{ 'role': 'developer' }

// درست:
{ "role": "developer" }

ج. کیز پر کوٹس نہ لگانا (Unquoted Keys)

JS آبجیکٹ میں آپ { age: 25 } لکھ سکتے ہیں، لیکن JSON میں کلید پر کوٹس لگانا ضروری ہے:

// غلط:
{ age: 25 }

// درست:
{ "age": 25 }

د. 64-بٹ بگ انٹ (BigInt) کی حساسیت

معیاری جاوا اسکرپٹ میں نمبرز IEEE 754 ڈبل پریسیژن پر کام کرتے ہیں، جس کی محفوظ حد 9,007,199,254,740,991 تک ہے۔ اس سے بڑے ڈیٹا بیس شناختی نمبرز (جیسے ٹویٹر اسنو فلیک IDs) عام JSON پارسنگ کے دوران خراب ہو سکتے ہیں۔ ایسے بڑے نمبرز کو بطور اسٹرنگ محفوظ رکھنا چاہیے۔

3. ڈیبگنگ کا طریقہ: درست سطر اور کالم کی نشاندہی

جب ہزاروں سطروں پر مشتمل API رسپانس میں ایرر آتا ہے تو آنکھوں سے تلاش کرنا ممکن نہیں ہوتا۔ GoToolstack کا JSON ٹول خرابی کی درست لوکیشن نکالتا ہے:

1. اپنا خام کوڈ بائیں باکس میں پیسٹ کریں۔
2. ایرر کا پتا لگانے کے لیے ویلیڈیٹر فورا سرخ مارکر کے ساتھ سطر نمبر (Line) اور کالم نمبر (Column) نمایاں کر دے گا۔
3. خرابی دور کرنے کے بعد "فارمیٹ کریں" پر کلک کریں تاکہ 2-اسپیس انڈنٹیشن کے ساتھ خوبصورت اور پڑھنے کے قابل ڈیٹا حاصل ہو۔

4. تکنیکی دیانت داری: خودکار جادوئی مرمت کا کوئی جھوٹا دعویٰ نہیں

تکنیکی معیارات اور مآخذ

• IETF RFC 8259: دی جاوا اسکرپٹ آبجیکٹ نوٹیشن (JSON) ڈیٹا انٹرچینج فارمیٹ۔
• ECMA-404: دی JSON ڈیٹا انٹرچینج سنٹیکس اسٹینڈرڈ۔