2013-03-19 6 views
16

मैंने हाल ही में हमारे जावास्क्रिप्ट कोड को दस्तावेज करने के लिए jsdoc टिप्पणियों का उपयोग करना शुरू कर दिया है, हालांकि मुझे @param टैग के उपयोग के विरोधाभासी उदाहरण मिल रहे हैं।जेएसडॉक टिप्पणियों के लिए उपयोग करने के लिए सही आवरण क्या है?

देखें https://code.google.com/p/jsdoc-toolkit/wiki/TagParam (PascalCase)

और https://developers.google.com/closure/compiler/docs/js-for-compiler (ऊंट/लोअरकेस)।

var foo = 1; 
console.log(typeof foo); // outputs "number" 

केस सही jsDoc @param टिप्पणी के लिए उपयोग करने के लिए क्या है:

CamelCase के बाद से मेरे लिए समझ में आता है? या यह कोई महत्त्व नहीं रखता? मैं दस्तावेज़ निर्माण के लिए इसका उपयोग करने की योजना बना रहा हूं और टाइपिंग जांचने के लिए Google क्लोजर के माध्यम से कोड चला रहा हूं।

धन्यवाद! String, Number, और Boolean:

उत्तर

16

JSDoc प्रकार भाव के लिए परस्पर विरोधी उदाहरण जावास्क्रिप्ट आदिम प्रकार string, number और boolean है, जो इसी आवरण प्रकार है शामिल है।

Closure: The Definitive Guide से

:

आवरण प्रकार के उपयोग, Closure Library में निषिद्ध है कुछ कार्यों ठीक से व्यवहार नहीं हो सकता है के रूप में आवरण प्रकार जहां आदिम प्रकार उम्मीद कर रहे हैं उपयोग किया जाता है, तो।

देखें MDN: Distinction between string primitives and String objects

+3

ज्यादातर मामलों में, आप ऑब्जेक्ट प्रकार के बजाय आदिम प्रकार चाहते हैं। आवश्यक होने पर संकलक स्वचालित रूप से आदिम प्रकार को बॉक्स (प्रचार) करेगा, लेकिन विपरीत नहीं है। –

+0

धन्यवाद cpeisert! मुझे निश्चित रूप से वह किताब मिलनी होगी! – magritte

+0

निश्चित रूप से करते हैं। यह सिर्फ एक बंद पढ़ने की जानकारी के लिए, एक महान पढ़ा है! – jordancpaul

संबंधित मुद्दे