ඕනෑම වෙබ් සංවර්ධකයෙකුට JSON (JavaScript Object Notation) සමඟ වැඩ කිරීම අත්යවශ්යයි. නමුත් කුඩා වැරදි – ත්රෙලින් කොමා, එකකොට්ටි උද්ධෘත ලකුණු, හෝ HTML පිටුවක් ආපසු ලැබීම – ඉතා අඩුවෙන් පවා කේතය බිඳ දැමිය හැක. Dev.to වෙතින් පළ වූ ලිපියෙහි, සාමාන්ය JSON දෝෂ 10ක්, ඒවාගේ හේතු හා නිවැරදි විසඳුම් සවිස්තරාත්මකව දක්වා ඇත.
මෙම මාර්ගෝපදේශය JavaScript, Python සහ PostgreSQL තුළ ප්රසිද්ධ පාර්සරයන් (parsers) දක්වා ඇති වැරදි පණිවුඩයන්ට සෘජු සම්බන්ධතා සපයයි. උදාහරණයක් ලෙස, Unexpected token ‘<’ යන පණිවුඩය ලැබුනහොත්, සේවාදායකය JSON නොව HTML පිටුවක් ආපසු එවූ බවයි. ඒ අනුව, Unexpected end of JSON input නම්, JSON හි දත්ත අඩුයැයි හෝ හිස්යැයි පෙන්වයි.
දෝෂයන්ගේ මූලික හේතු වන්නේ:
- Trailing commas – අවසානයේ කොමා එකතු කිරීම.
- Single‑quoted strings – ‘ ’ භාවිතය.
- Unquoted keys – ගුණ නාමයන් උද්ධෘත නොකිරීම.
- Comments – JSON හි අදාල සටහන් නොමැති වීම.
- Python literals – true/false වෙනුවට True/False භාවිතය.
- Control characters – නවපේළි, ටැබ් වැනි අක්ෂරයන් අනිසි ලෙස ඇතුළත් කිරීම.
- Duplicate keys – එකම ගුණ නාමය දෙවරක් භාවිත කිරීම.
- Numeric oddities – ඉදිරිපස ශූන්ය, NaN, Infinity, හෝ hexadecimal අංක.
මෙම දෝෂයන් හඳුනා ගැනීමට JSON validator හෝ linter භාවිතා කිරීම ඉතා ප්රයෝජනවත්. ඒ මඟින් පේළි හා තීරුවේ ස්ථානය නිරවද්යව දක්වා, නිවැරදි සංස්කරණය සිදු කළ හැක.
ශ්රී ලංකාවට ඇති වැදගත්කම
- සිසුන් – JSON පරික්ෂාවෙහි දෝෂ හඳුනා ගැනීමට නව ක්රම ඉගෙන ගනිමින්, API පරිසරය හා දත්ත ගොඩනැගීමේ පදනම් දැනුම වැඩි කර ගනිති.
- ඩෙවලපර් – JavaScript, Python, PostgreSQL යන ප්රධාන තාක්ෂණයන්ට අදාළ වැරදි පණිවුඩයන්ට වේගවත් විසඳුම් ලැබීමෙන් කාලය ඉතිරි කර, නිෂ්පාදන කාර්යක්ෂමතාවය වැඩි කරයි.
- ව්යාපාර – නිවැරදි JSON සැකසීම මගින් බාහිර API සමඟ සම්බන්ධතා, දත්ත විශ්ලේෂණ, මයික්රෝසේවා (micro‑services) ආදිය නිසි ලෙස ක්රියාත්මක වේ. එය සේවා අඩංගුභාවය හා පාරිභෝගික අත්දැකීම උසස් කරයි.
අවසන් වශයෙන්, JSON දෝෂ මූලික වශයෙන් කුඩා අක්ෂර හෝ සංකේත ගැටළුවක් නිසා සිදුවේ. එය නිවැරදිව හඳුනා ගැනීම සහ නිවැරදි සැකසීම ඔබේ කේතය ස්ථාවර කරයි, වැඩි කාලය ඉතිරි කරයි, සහ ලොව පුරා තාක්ෂණික පද්ධති සමඟ සම්බන්ධ වීමට අවශ්ය විශ්වාසය ලබා දෙයි.
