সিঙ্গারা খেতে খেতে জাভেদ বলল, সব সময় যে কোড লিখবি, এমন না। মাঝেমধ্যে কোডের মাঝে মাঝে কিছু কথা বা কিছু তথ্য লিখে রাখার দরকার পড়বে। এইটা সাধারণত কোড বুঝার জন্য হেল্প করে। এমন হতে পারে, কোডটা একটু ট্রিকি বা কোড দেখে বুঝা যাচ্ছে না, কী কাজ করবে। তখন বাড়তি কিছু নোটস বা তথ্য লিখে রাখলে কোড বুঝতে সুবিধা হয়।
এই বাড়তি নোট কিন্তু কোড না। এই বাড়তি নোট কোনো আউটপুট দেখাবে না বা কোডের ডাইরেক্ট কাজে লাগবে না। তবে কোড বুঝার জন্য কাজে লাগবে।
এই কাজটা আমরা অনেক সময় করি। যেমন, বই পড়ার সময় বইয়ের লেখার ফাঁকে ফাঁকে বা সাইডে বা কোণার মধ্যে অনেকেই বিভিন্ন নোটস, চিরকুট বা এক্সট্রা কিছু কথা লিখে রাখে। পরবর্তীতে ওই জিনিসগুলো বুঝার জন্য কাজে লাগে।
কোডের মধ্যে মাঝেমধ্যে একটু নোটস বা কথা লিখে রাখার বিষয়কে কমেন্টস (comments) করা বলে।
কমেন্টস কোনো কোড না। এইগুলা কোড হিসেবে রান হবে না। কোনো আউটপুট দিবে না। শুধু ডেভেলপার দেখার জন্য বা বুঝার জন্য বা কী করতেছে, সেটা ফিউচারে দেখলে যেন বুঝতে পারে বা একজনের কোড আরেকজন দেখলে যেন বুঝতে সুবিধা হয়।
অনেক সময় ভেরিয়েবলের মান দেখেও বুঝা যায় না বা কোনো কারণে কোড একটু জটিল হয়ে যায়, তখন কমেন্ট খুব কাজে লাগে। এ ছাড়াও কোডের কোনো জায়গায় একটু নতুন জিনিস আছে, সেটা বুঝানোর জন্য কমেন্ট খুব কাজে দেয়।
এক লাইনের কমেন্ট
যেমন ধর, একটা ভেরিয়েবল আছে।
const userLevel = 4;এখন এইখানে userLevel-এর মান 4 বলতে আসলে কী বুঝায়, সেটা কিন্তু ক্লিয়ার না। হতে পারে আমাদের এইখানে অনেক ধরনের ইউজার আছে। তাদের মধ্যে হয়তো 4 লেভেলের ইউজার মানে একজন অ্যাডমিন। সে ক্ষেত্রে নতুন কেউ কোড দেখলে বা অনেক দিন পর নিজেই নিজের কোড দেখলে বুঝতে পারবে না। সে ক্ষেত্রে ছোট একটা কমেন্ট লিখে রাখলে খুবই কাজে দেয়।
কমেন্ট লেখার সবচেয়ে সহজ উপায় হচ্ছে, লাইনের শুরুতে দুইটা ফরওয়ার্ড স্ল্যাশ চিহ্ন (পরপর দুইবার কোনো গ্যাপ ছাড়া), তারপর দুইটা স্ল্যাশের পর যা খুশি লিখতে পারবি। সেটাই কমেন্ট হয়ে যাবে।
// make user adminএই কোডের কোনো আউটপুট থাকবে না। তাই ভেরিয়েবল এবং কমেন্টসহ দেখতে এমন হবে—
// make user admin
const userLevel = 4;আবার কখনো কখনো কোড করার সময় কোনো একটা লাইন কোড বন্ধ করে আউটপুট চেক করতে চাইলে সেই লাইন ডিলিট বা রিমুভ করা যায়। কমেন্টও করে রাখতে পারে। কোনো কোডের লাইনের আগে দুইবার ফরওয়ার্ড স্ল্যাশ দিলে সেই লাইন কিন্তু কমেন্ট হয়ে যাবে। আর কমেন্ট হয়ে গেলে সেই লাইনের কোড কাজ করবে না।
const price = 100;
// price = 50;
console.log(price)
output: 100অনেক লাইনের কমেন্ট
মাঝে মাঝে তোর মাথায় এত কিছু চলে, একটা লাইনে লেখা সম্ভব না, তখনই অনেক লাইনের কমেন্ট লিখতে হয়। সে ক্ষেত্রে প্রত্যেক লাইনের শুরুতে দুইটা করে স্ল্যাশ চিহ্ন দিতে পারস—
// Total number of items in the shopping cart.
// This value is initially set to 0 because the user hasn't added any items yet.
// It will increase whenever the user adds an item to the cart. let totalItems = 0;কখনো যদি অনেক লাইনের কমেন্ট লেখার দরকার হয়, কিন্তু প্রত্যেক লাইনে দুইটা করে ফরওয়ার্ড স্ল্যাশ লিখতে না চাস, তাহলেও একটা সমাধান আছে। সেটা হচ্ছে— একদম কমেন্ট লেখার শুরুতে স্ল্যাশ(/) দিয়ে একটা এস্টেরিস্ক (*) সিম্বল দিবি। স্ল্যাশ আর এস্টেরিস্ক সিম্বলের মধ্যে কোনো গ্যাপ দিবি না।
তারপর একদম পুরা কমেন্ট লেখা শেষ হওয়ার পর একটা এস্টেরিস্ক (*) এবং তারপর একটা স্ল্যাশ দিয়ে দিবি। তাহলেই হবে নিচের মতো করে।
/*
This variable stores the maximum number of attempts a user is allowed
to make while logging into their account. It is set to 3. If the user exceeds
this limit, their account will be temporarily locked.
*/ let maxLoginAttempts = 3;যদিও ভেরিয়েবলের নাম এমনভাবে দেয়া উচিত, যাতে নাম দেখে বুঝা যায়, এইটা কী জিনিস। তবে এইটা সব সময় করা সম্ভব হয় না। তখন কমেন্ট খুব দরকারি হয়ে ওঠে।
তা ছাড়া কমপ্লেক্স কোড নিয়ে কাজ করার সময় কমেন্ট করা খুবই দরকারি হয়ে ওঠে।
Practice:
- তুই score নামে একটা ভেরিয়েবল লিখ। এখন এইটা কীসের স্কোর, সেটা ভেরিয়েবলের নাম দেখে বুঝা যাচ্ছে না। তাই এই ভেরিয়েবল ডিক্লেয়ার করার ওপরে এক লাইন কমেন্ট লিখ। কমেন্টে থাকবে, এইটা কীসের স্কোর।
- এখন radius নামে একটা ভেরিয়েবল লিখ। তারপর এইটা কীসের রেডিয়াস, সেটা বুঝানোর জন্য তিন লাইনের কমেন্ট লিখ। প্রত্যেক লাইনের আগে স্ল্যাশ চিহ্ন দিয়ে কমেন্ট লিখবি।
- তোর পছন্দের জামা কয়টা, সেটা নিয়ে dress নামে একটা ভেরিয়েবল ডিক্লেয়ার কর। তারপর সেটার ওপর মাল্টিলাইন কমেন্ট লিখ স্ল্যাশ এবং এস্টেরিস্ক চিহ্ন দিয়ে।
- তোকে একটা গিফট হিসেবে 100 টাকা দেওয়া হয়েছে, giftMoney নামে একটা ভেরিয়েবলে রাখ। তারপর কমেন্টে লিখবি, এই টাকা কী কারণে দেওয়া হয়েছে।
- তুই ঠিক করলি 7 ঘণ্টা পড়ালেখা করবি। studyTime নামে একটি ভেরিয়েবলে রাখ। তার ওপর চার-পাঁচ লাইনের কমেন্ট লিখ, এই 7 ঘণ্টার মধ্যে কোন কোন সাবজেক্টের কী কী জিনিস তুই কতক্ষণ ধরে পড়বি।
- তোর মোবাইল পেমেন্টের জন্য sendMoney নামে একটি ভেরিয়েবল ডিক্লেয়ার কর। তার ওপর দুই লাইনের কমেন্ট লিখ, যাকে মানি সেন্ড করতেছস, সে কত টাকা পাবে, আর সার্ভিস ফি কত টাকা।
- তুই অনলাইন থেকে একটা প্রোডাক্ট অর্ডার করছস। তোর কাছ থেকে মোট কত টাকা নিবে, সেটা pay নামে একটা ভেরিয়েবলে রাখ। তারপর ওপরে এক লাইন কমেন্ট লিখবি। এই টাকার মধ্যে প্রোডাক্টের দাম এবং ডেলিভারি ফি যোগ করা আছে।