Node.js පදනම් කළ වෙබ් යෙදුම් ලියන විට, Prisma යන ORM එකේ දෝෂ පරිච්ඡේදය සැකසීම අතිශය වැදගත්. නමුත් එක් එක් controller එකේ try/catch ලියලා, දෝෂ කේතය පරීක්ෂා කර, HTTP status code තෝරා, ප්රොඩක්ෂන් පරිසරයේ දත්ත සඟවා යැවීම යන වැඩ පුරුදුමට පත් වේ.
උදාහරණයක් ලෙස, අලුතින් පරිශීලකයෙක් එක්කෙරෙන්නා වූ route එකේ PrismaClientKnownRequestError (කේතය P2002) හමුවේ 409 Conflict යැවීමට කේතයක් ලියන්න ඕනෑ. එවැනි පරීක්ෂා කේතය තවත් controller කීපයකත් පෙනේ.
මෙම පුරුද්ද ඉවත් කරන්නේ "ds-express-errors" නමැති npm පැකේජය භාවිතා කිරීමෙන්. එය Prisma දෝෂ හඳුනාගෙන, ඒවාට සුදුසු HTTP ප්රතිචාරයක් ස්වයංක්රීයව සකසයි. ඒ නිසා ඔබට එක්වරම ග්ලෝබල් middleware එකක් සකස් කර, සියලු routes වලට ඒක යොදා ගත හැක.
පැකේජය ස්ථාපනය කිරීම සරලයි: npm install ds-express-errors. Express සහ Prisma Client ඔබේ ප්රොජෙක්ට් එකේ දැනටමත් තිබේ නම්, වෙනත් කිසිවක් කරන්න අවශ්ය නැත.
ඉන්පසු, Prisma error classes import කර, setConfig මාර්ගයෙන් mapper සක්රිය කරන්න. needMappers: ['prisma'] ලෙස සකස් කළහොත් Prisma mapper පමණක් ක්රියාත්මක වේ. errorClasses: { Prisma } එකතු කිරීමෙන් version 1.9.0 හි instanceof පරීක්ෂාව තද කරයි, එය අනිවාර්ය නොවුවත් ඉතා ප්රයෝජනවත්.
Controller එකේ දැන් try/catch අවශ්ය නැත. asyncHandler wrapper එක භාවිතා කර, async function එකක් පැවරීම පමණක් ප්රමාණවත්. Prisma දෝෂයක් හටගත් විට, එය ස්වයංක්රීයව ග්ලෝබල් error middleware වෙත යොමු වේ.
උදාහරණයක් ලෙස, එකම email එකකින් පරිශීලකයෙක් තවත් එක්කන්න උත්සාහ කළහොත් Prisma "P2002" දෝෂයක් නිකුත් කරයි. ds‑express‑errors එය 409 Conflict ලෙස පරිවර්තනය කර, ප්රතිචාරය {"status":"fail","message":"Conflict"} ලෙස ලබා දෙයි. එමෙන්ම, නොමැති resource එකක් update/delete කිරීමට උත්සාහ කළ විට "P2025" දෝෂය 404 Not Found ලෙස මාරු වේ.
අවසානව, සියලු routes පසුගියව ග්ලෝබල් error handler එක app.use(errorHandler) ලෙස එකතු කිරීම මඟින්, අඩු කේතයකින් සම්පූර්ණ error management එකක් සම්පූර්ණ කරගත හැක.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ තරුණ සංවර්ධකයන්, startup ආරම්භකයන්, සහ IT සමාගම් සියලුම Node.js/Express පදනමක API නිර්මාණය කරන විට, මෙම පැකේජය කාලය හා දෝෂ පරීක්ෂණය අඩු කරයි. කේතය කෙටි කර, maintainability වැඩි කර, production පරිසරයේ ආරක්ෂිත ප්රතිචාර ලබා දීමෙන් පාරිභෝගික විශ්වාසය ඉහළ යයි. තවද, පාඨමාලා හා bootcamp ගැලපීම් වලදී, දෝෂ සැකසුම් ගැන විස්තරාත්මක උදාහරණයක් ලෙස භාවිතා කළ හැකි බැවින්, සිසුන්ට real‑world development practice එකක් ලබා දේ.
කොටසක් ලෙස, ග්ලෝබල් error handler එකක් සකස් කිරීමෙන්, ආයතනික මට්ටමේ logging, monitoring, සහ alerting ක්රියාවලියන් සමඟ සරලව ඒකාබද්ධ කළ හැක. එමඟින්, ශ්රී ලංකාවේ තාක්ෂණික සමාජය වඩාත් පවතින, scalable, සහ secure backend solutions එකක් ගොඩනැගීමට ඉඩ ලැබේ.
එබැවින්, Express + Prisma යන සංයෝගය භාවිතා කරන ඕනෑම සංවර්ධකයෙකුට ds‑express‑errors 1.9.0 නවතම සංස්කරණය අත්හදා බැලීමට නිර්දේශ කරයි. ඔබේ API ගොඩනැගීම තවත් වේගවත්, පවතින, සහ පාරිභෝගික‑හිතකාමී වේ.
