Course Progress 35%

JavaScript Comments

JavaScript में Comments का उपयोग code को explain करने के लिए किया जाता है। Comments programmer के लिए होते हैं, browser के लिए नहीं। JavaScript engine comments को completely ignore कर देती है, यानी comments execute नहीं होते।

Comments का main purpose यह होता है कि code को पढ़ने वाला व्यक्ति आसानी से समझ सके कि code क्या कर रहा है और क्यों लिखा गया है। Beginner के लिए comments बहुत important होते हैं क्योंकि इससे learning आसान हो जाती है।

JavaScript में Comments क्यों जरूरी होते हैं

JavaScript comments कई कारणों से use किए जाते हैं:

  • Code को easy और readable बनाने के लिए
  • Complex logic को explain करने के लिए
  • Future reference के लिए
  • Temporary रूप से code को disable करने के लिए
  • Team में काम करते समय दूसरे developers को समझाने के लिए

Comments code के behavior को change नहीं करते, लेकिन understanding को बहुत बेहतर बना देते हैं।

JavaScript Single-line Comments

Single-line comment एक ही line में लिखा जाता है और // से start होता है।

Example: Single-line Comment

<script>
// This is a single-line comment
let x = 10;
</script>

इस code में पहली line एक comment है। JavaScript इसे ignore कर देगी।

दूसरी line में x नाम का variable बनाया गया है और उसमें value 10 store की गई है।

Single-line comment इसलिए use किया जाता है जब हमें किसी एक line या short explanation देनी होती है।

इस code का output screen पर नहीं दिखेगा, लेकिन memory में x की value 10 store हो जाएगी।

Code के बाद Single-line Comment

Single-line comment code के बाद भी लिखा जा सकता है।

Example: Inline Comment

<script>
let y = 20; // y stores the value 20
</script>

यहां // y stores the value 20 सिर्फ explanation के लिए है।

JavaScript सिर्फ let y = 20; को execute करेगी।

इस तरह के comments तब useful होते हैं जब किसी variable या statement का purpose तुरंत समझाना हो।

JavaScript Multi-line Comments

Multi-line comment कई lines में लिखा जा सकता है। यह /* से start होता है और */ पर end होता है।

Example: Multi-line Comment

<script>
/*
This is a multi-line comment
JavaScript ignores all these lines
This is useful for long explanations
*/
let total = 50;
</script>

इस code में comment block के अंदर लिखा हुआ text execute नहीं होगा।

let total = 50; statement variable total में value 50 store करती है।

Multi-line comments इसलिए use किए जाते हैं जब explanation लंबी हो या एक से ज्यादा lines में लिखनी हो।

Multi-line Comment का Practical Use

Multi-line comments का use अक्सर functions, logic blocks या बड़े sections को explain करने के लिए किया जाता है।

Example: Explanation के लिए Multi-line Comment

<script>
/*
The following code calculates
the sum of two numbers
and stores the result
*/
let a = 10;
let b = 20;
let sum = a + b;
</script>

यह code step-by-step काम करता है।

पहले a और b variables बनते हैं।
फिर दोनों values add होकर sum variable में store होती हैं।

Comment block पूरे logic को explain करता है ताकि reader को clear idea मिल सके।

इस code का final result memory में sum = 30 होगा।

JavaScript Comments से Code Disable करना

Comments का एक important use यह भी होता है कि code को temporarily disable किया जाए।

Example: Single-line Comment से Code Disable करना

<script>
let x = 10;
// let y = 20;
</script>

यहां y वाला code comment कर दिया गया है।

JavaScript सिर्फ x = 10 को execute करेगी।
y वाला code completely ignore हो जाएगा।

Multi-line Comment से Multiple Lines Disable करना

<script>
/*
let a = 5;
let b = 10;
*/
let c = 20;
</script>

यहां a और b वाले statements execute नहीं होंगे।

JavaScript सिर्फ c = 20 को execute करेगी।

यह technique debugging और testing के समय बहुत useful होती है।

JavaScript Comments और Output

Comments कभी भी output produce नहीं करते।

Example: Comment और Output Comparison

<script>
// console.log("Hello");
console.log("JavaScript Running");
</script>

पहली line comment होने की वजह से execute नहीं होगी।

दूसरी line console में JavaScript Running print करेगी।

इस code का output browser console में दिखाई देगा।

JavaScript Comments Best Practices

JavaScript comments लिखते समय कुछ best practices follow करनी चाहिए:

  • Comments short और clear होने चाहिए
  • Obvious चीज़ों पर unnecessary comments avoid करें
  • Complex logic पर जरूर comment लिखें
  • Old या misleading comments remove करें
  • Code और comment में mismatch नहीं होना चाहिए

Correct तरीके से लिखे गए comments JavaScript code को professional और easy-to-understand बनाते हैं।