JSON Toolkit

JSON অ্যারে ও অবজেক্ট লেখার নিয়ম: স্ট্রাকচার ও নেস্টিং পরিচিতি

সংক্ষেপে: JSON-এ মাত্র দুটি কনটেইনার আছে: নাম দেওয়া ফিল্ডের জন্য অবজেক্ট, সাজানো তালিকার জন্য অ্যারে। কীভাবে দুটো মেলাবেন, সঠিকটা বেছে নেবেন এবং তিনটি সবচেয়ে ঘন ঘন ভুল ঠিক করবেন — সংখ্যা কী দিয়ে বানানো ভুয়া অ্যারে, শেষের অতিরিক্ত কমা আর এককোটেশন।

শিক্ষানবিশ~6 মিনিট পড়াপ্রকাশ 2026-11-20আপডেট 2026-11-20
JSON অ্যারে ও অবজেক্ট স্ট্রাকচার পরিচিতির কভার

JSON আপনাকে মাত্র দুটি কনটেইনার দেয়: অবজেক্ট বহন করে নাম দেওয়া ফিল্ড, অ্যারে বহন করে সাজানো তালিকা — এবং প্রায় প্রতিটি ভাঙা payload-এর ব্যাখ্যা হলো কোটেশন, কমা, অথবা ভুয়া অবজেক্ট হিসেবে লেখা একটি তালিকা।

এক: JSON-এ মাত্র দুটি কনটেইনার

API রেসপন্স যত জটিলই হোক, সব নেমে আসে দুটি কনটেইনার ও ছয় ধরনের ভ্যালুতে। অবজেক্ট হলো কার্লি ব্রেস {}-এ মোড়ানো কী/ভ্যালু জোড়ার সংগ্রহ; অ্যারে হলো স্কয়ার ব্র্যাকেট []-এ মোড়ানো ভ্যালুর সাজানো তালিকা। একটি ভ্যালু হতে পারে স্ট্রিং, সংখ্যা, true, false, null — অথবা আবার অবজেক্ট বা অ্যারে। অ্যারের ভেতরে অবজেক্ট, অবজেক্টের ভেতরে অ্যারে: এই রিকার্শনই JSON-এর সম্পূর্ণ অভিব্যক্তি ক্ষমতা।

{
  "user": { "name": "Ada", "active": true },
  "roles": ["admin", "editor"],
  "lastLogin": null,
  "loginCount": 42
}

এ থেকে একটি ব্যবহারিক উপসংহার আসে: এলোমেলো payload দেখলে অক্ষরে অক্ষরে পড়বেন না। আগে দেখুন বাইরের অক্ষরটা { নাকি [। অবজেক্ট হলে এটিকে নাম দেওয়া ফিল্ড হিসেবে পড়ুন; অ্যারে হলে তালিকা হিসেবে পড়ুন, তারপর এক এক করে লেভেলে নামুন। json.org-এর সিনট্যাক্স ডায়াগ্রাম ঠিক এক পাতায় আঁটে কারণ দুটি স্ট্রাকচার আর রিকার্শন মিলে সবকিছু ঢেকে দেয়।

দুই: অবজেক্ট লেখা, চারটি কঠোর নিয়ম

অবজেক্টেই শিক্ষানবিশরা সবচেয়ে বেশি ভুল করে, কিন্তু নিয়মগুলো নেমে আসে চারটিতে:

  1. কী অবশ্যই ডাবল কোটেশনে মোড়ানো স্ট্রিং হতে হবে। {name: "Ada"} এবং {'name': 'Ada'} দুটোই অবৈধ; লিখতে হবে {"name": "Ada"}। JavaScript অবজেক্ট লিটারেল নাকি কী ও এককোটেশন চালু করে, JSON করে না — দুটোর মধ্যে এই বিভ্রান্তিই সবচেয়ে কমন।
  2. জোড়াগুলো কমা দিয়ে আলাদা করুন এবং শেষ জোড়ার পরে কখনও কমা রাখবেন না। {"a": 1, "b": 2,} ব্যর্থ হয় Unexpected token } দিয়ে, ক্লোজিং ব্রেসে।
  3. কী ইউনিক হওয়া উচিত। RFC 8259 এটিকে SHOULD বলে, MUST বলে না: ডুপ্লিকেট কী ত্রুটি দেয় না, কিন্তু প্রথম ভ্যালু থাকবে নাকি শেষটা থাকবে তা ইমপ্লিমেন্টেশনের ওপর নির্ভর করে, আর ভাষাগুলোর মধ্যে অমিল আছে। কখনও এর ওপর ভরসা করবেন না।
  4. কী-এর ক্রমের কোনো অর্থ নেই। {"a":1,"b":2} আর {"b":2,"a":1} একই অবজেক্ট; diff টুল ও তুলনার ফাংশন কী-এর ক্রম অগ্রাহ্য করে। যদি ক্রম গুরুত্বপূর্ণ হয়, ডেটা তখন অ্যারের হবে।

তিন: অ্যারে লেখা, ক্রমটাই ডেটা

অ্যারে ভ্যালু সাজায় পজিশন দিয়ে, আর ইনডেক্সিং শুরু হয় 0 থেকে: ["admin", "editor"]-এ "editor" স্ট্রিংটি হলো [1]। এই ক্রম অর্থবহ — অ্যারে আর অবজেক্টের মধ্যে মূল পার্থক্য এখানেই। রিলেভ্যান্স অনুযায়ী সাজানো সার্চ রেজাল্ট, তারিখ অনুযায়ী সাজানো লগ এন্ট্রি: এই তথ্য শুধু ক্রমেই বাস করে, আর অবজেক্টে রূপান্তর করলে তা ধ্বংস হয়ে যায়।

দুটি ব্যবহারিক পরামর্শ। প্রথমত, এলিমেন্ট হোমোজেনিয়াস রাখুন: [{"id":1},{"id":2}] খাওয়া অনেক সহজ, যেখানে [1, "text", true] বৈধ হলেও প্রতিটি কনজিউমারকে প্রতি ধাপে টাইপ পরীক্ষা করতে বাধ্য করে। দ্বিতীয়ত, খালি অ্যারে [] সম্পূর্ণ বৈধ ভ্যালু — তালিকার ফিল্ডে এখনও কনটেন্ট না থাকলে null না পাঠিয়ে [] পাঠান, যাতে কনজিউমারকে আগে অস্তিত্ব আর পরে খালি খালি পরীক্ষা না করতে হয়।

[
  { "city": "Tokyo", "population": 13960000 },
  { "city": "Delhi", "population": 16780000 }
]

চার: নেস্টিং, আসল payload-এর চারটি আকৃতি

আসল ডেটা আসলে এই দুটি কনটেইনারই, একে অপরের ভেতরে নেস্ট করা, আর প্যাটার্ন নেমে আসে চারটি আকৃতিতে:

আকৃতি দেখতে কেমন সাধারণ ব্যবহার
অবজেক্টের ভেতরে অ্যারে {"tags": ["a","b"]} এন্টিটির তালিকা ফিল্ড
অবজেক্টের অ্যারে [{"id":1},{"id":2}] রেকর্ড তালিকা, পেজিনেটেড রেজাল্ট
অবজেক্টের ভেতরে অবজেক্ট {"db": {"host": "..."}} দলবদ্ধ কনফিগ, অ্যাড্রেস ব্লক
অ্যারের অ্যারে [[1,2],[3,4]] ম্যাট্রিক্স, টেবিলের রো

একটি সাধারণ API রেসপন্স অবজেক্টকে খোলস হিসেবে আর অ্যারেকে কনটেন্ট হিসেবে ব্যবহার করে:

{
  "code": 0,
  "data": {
    "items": [
      { "id": 1, "title": "first" },
      { "id": 2, "title": "second" }
    ],
    "page": 1,
    "total": 2
  }
}

শুধু নেস্ট করার জন্য নেস্ট করবেন না। তিন-চার লেভেলের ওপারে অ্যাক্সেস পাথ অপাঠ্য হয়ে যায়, আর কনজিউমার কোডও ততগুণ ফুলে ওঠে। যেসব ফিল্ড সবসময় একসঙ্গে চলে, তারা সাব-অবজেক্টে যাবে: addrCity আর addrZip-কে বদলে দিন address: {city, zip} দিয়ে।

পাঁচ: অবজেক্ট না অ্যারে, একটি সিদ্ধান্ত টেবিল

প্রশ্ন উত্তর কেন
প্রতিটি ভ্যালুর কি নাম আছে? অবজেক্ট কী দিয়ে অ্যাক্সেস; ফিল্ড যোগ বা বাদ দিলে কিছু ভাঙে না
এটি কি একই রকম রেকর্ডের তালিকা? অ্যারে ক্রম গুরুত্বপূর্ণ; map ও filter করা যায়
কী দিয়ে দ্রুত খোঁজা দরকার? আইডি দিয়ে ইনডেক্স করা অবজেক্ট ঘুরে দেখার বদলে O(1) অ্যাক্সেস
একই এন্টিটির একাধিক বৈশিষ্ট্য? অবজেক্ট বৈশিষ্ট্যগুলোর নিজস্ব ক্রম নেই
একই রকম আইটেমের বাড়তে থাকা সংগ্রহ? অ্যারে দৈর্ঘ্য নিয়ন্ত্রণহীনভাবে বাড়ে

একটি অ্যান্টি-প্যাটার্ন বিশেষভাবে উল্লেখ প্রাপ্য: কী হিসেবে "0", "1", "2" দিয়ে অবজেক্ট বানিয়ে অ্যারে নকল করা। এটি ত্রুটি ছাড়াই পার্স হয়, কিন্তু আপনি হারান সত্যিকারের অ্যারের দৈর্ঘ্য-সিমান্টিকস আর ইটারেশন টুল, আর কনজিউমারদের কিছু পড়ার আগে Object.keys সাজাতে হয়। যদি কীগুলো ধারাবাহিক সংখ্যা হয়, সত্যিকারের অ্যারে লিখুন। উল্টোটাও সত্য: [{"key":"theme","value":"dark"}] জাতীয় কী/ভ্যালু জোড়ার তালিকা {"theme": "dark"} অবজেক্টের চেয়ে নিকৃষ্ট — যতক্ষণ না কীগুলো সত্যিই ডায়নামিক এবং আগে থেকে ঘোষণা করা সম্ভব নয়।

ছয়: তিনটি ঘন ঘন ভুল ও তাদের বার্তা

ভুল রূপ সাধারণ ত্রুটি সমাধান
শেষের কমা {"a":1,} Unexpected token } শেষ কমা বাদ দিন
এককোটেশন / নাকি কী {name:'Ada'} Unexpected token ' / Expected property name কী ও স্ট্রিংয়ে সবসময় ডাবল কোটেশন
Python লিটারেল True / None Unexpected token T বদলে দিন true / null
সংখ্যা কী দিয়ে ভুয়া অ্যারে ত্রুটি নেই, সিমান্টিকস ভুল সত্যিকারের অ্যারে হিসেবে আবার লিখুন

দুটি ডিবাগিং অভ্যাস: পার্সার সাধারণত দোষী অক্ষরের পরের পজিশন জানায়, তাই position 42 দেখলে এক-দুই অক্ষর পিছনে তাকান; আর এক লাইনের বিশাল JSON আগে ফরম্যাট করুন — লাইন ও কলাম নম্বর ক্যারেক্টার অফসেটকে প্রতিবার হারায়। ত্রুটির পূর্ণ ক্যাটালগ আছে JSON ত্রুটি লুকআপ টেবিলে, আর ধাপে ধাপে ট্রায়াজ প্রক্রিয়া আছে JSON পার্স ত্রুটি কীভাবে ঠিক করবেন-এ।

সাত: লেখার পরে স্ট্রাকচার যাচাই করুন

হাতে লেখা JSON জমা দেওয়ার আগে সবসময় পার্সার দিয়ে যেতে হবে। সবচেয়ে হালকা যাচাই এক লাইনের কমান্ডেই হয়:

python3 -m json.tool config.json > /dev/null && echo OK
jq empty config.json && echo OK

অনলাইনে JSON ফরম্যাটার ও ভ্যালিডেটর পাতায় কনটেন্ট পেস্ট করুন — সিনট্যাক্স ত্রুটি লাইন ও কলাম সহ ফিরে আসবে। ট্রি ভিউতে গেলে প্রতিটি লেভেলের টাইপ এক নজরে দেখা যায়: কোনো সংখ্যা স্ট্রিং হিসেবে পড়া হয়েছে কি না, অ্যারের দৈর্ঘ্যগুলো মিলছে কি না। আর পাঠক যখন টেকনিক্যাল নন, অবজেক্ট-অ্যারে payload JSON থেকে টেবিল পাতায় রো ও কলামে বিছিয়ে দেখানো যায় — এতে কাকতালীয়ভাবে যাচাই হয় আপনার ডেটা সত্যিই নিয়মিত রেকর্ড তালিকা কি না।

যে ফিল্ডটার অ্যারে হওয়া উচিত ছিল কিন্তু হয়নি, বা অতিরিক্ত গভীর নেস্টিং নতুন করে সাজানোর প্রশ্নগুলো টাইপ মডেলিংয়ের বিষয় — পরের পাঠ ছয় ধরনের টাইপ, সংখ্যার নির্ভুলতা ও এনকোডিং ফাঁদ।

JSON অ্যারে ও অবজেক্ট কি একে অপরে রূপান্তর করা যায়?

যায়, তবে ক্ষতি ছাড়া নয়। অবজেক্টকে অ্যারে বানানো মানে সাধারণত কীগুলোকে ভ্যালু বানানো আর কী অ্যাক্সেস হারানো; অ্যারেকে অবজেক্ট বানাতে প্রতিটি এলিমেন্টের জন্য কী বানাতে হয়, আর সেই কীগুলোর উৎস নতুন এক ডিজাইন সমস্যা। সিনট্যাক্সের সুবিধা দেখে নয়, কনজিউমার কীভাবে ডেটা পড়ে সেটা দেখে সিদ্ধান্ত নিন।

অবজেক্টের কী কি ডুপ্লিকেট হতে পারে?

সিনট্যাক্স অনুযায়ী পারে — RFC 8259 শুধু বলে কী SHOULD ইউনিক হওয়া। কিন্তু JavaScript শেষ ভ্যালু রাখে, অথচ C-পরিবারের কিছু লাইব্রেরি প্রথমটা রাখে: পার্সার অনুযায়ী আচরণ আলাদা। সিগনেচার, diff বা হ্যাশে ডুপ্লিকেট কী সরাসরি অমিল ডেকে আনে। প্রোডিউসার দিকে এগুলো এড়িয়ে চলুন, আর অজানা উৎসের ডুপ্লিকেটকে কনজিউমার দিকের ঝুঁকি ধরুন।

অ্যারে কি বিভিন্ন টাইপের ভ্যালু রাখতে পারে?

সিনট্যাক্স অনুযায়ী পারে: [1, "a", true] বৈধ JSON। কিন্তু হেটেরোজেনিয়াস অ্যারে কনজিউমার কোডের প্রতিটি পজিশনে টাইপ পরীক্ষা বাধ্য করে, আর স্কিমায় এগুলো প্রকাশ করাও কঠিন। ম্যাট্রিক্স ও টুপল ছাড়া — যেখানে পজিশনই সিমান্টিকস — অ্যারে হোমোজেনিয়াস রাখুন।

{name:'json'} কেন ভ্যালিডেশনে ব্যর্থ হয়?

কারণ JSON প্রতিটি কী ও প্রতিটি স্ট্রিং ভ্যালুর চারপাশে ডাবল কোটেশন দাবি করে। {name:'json'} একটি JavaScript অবজেক্ট লিটারেল, JSON নয়। {"name": "json"} লিখলেই ভ্যালিডেশন পাস করবে। এককোটেশন, নাকি কী ও কমেন্ট থাকে JSON5/JSONC-এর মতো ডায়ালেক্টে, যেগুলোর জন্য স্ট্যান্ডার্ড JSON.parse-এর বদলে নিজস্ব পার্সার লাগে।