पुल के रूप में JSDoc प्रकार एनोटेशन
रूपांतरण से पहले JSDoc की सहायता से JS फ़ाइलों में प्रकार जोड़ें
पुल के रूप में JSDoc प्रकार एनोटेशन, CoddyKit पर TypeScript Academy का एक निःशुल्क पाठ है। यह 4 में से 2वाँ पाठ है। आप नीचे पूरा पाठ निःशुल्क पढ़ सकते हैं—फिर अंतर्निहित कोड संपादक और 24/7 एआई ट्यूटर के साथ ब्राउज़र में इसका व्यावहारिक अभ्यास कर सकते हैं। यह TypeScript Academy सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। TypeScript Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
TypeScript के सेतु के रूप में जेएसडॉक
checkJs: true सक्षम होने पर TypeScript JavaScript फ़ाइलों में जेएसडॉक प्रकार-एनोटेशन पढ़ सकता है। इससे फ़ाइलों का नाम बदले बिना JS में प्रकार जोड़े जा सकते हैं।
/** @type {string} */
let name = "Alice"; // TypeScript checks this as string@param और @returns
जेएसडॉक टैग का उपयोग करके फ़ंक्शन के पैरामीटर और लौटाए जाने वाले प्रकारों पर एनोटेशन जोड़ें।
/**
* @param {string} name
* @param {number} age
* @returns {string}
*/
function greet(name, age) {
return `${name} is ${age}`;
}ऑब्जेक्ट प्रकारों के लिए @typedef
जेएसडॉक में दोबारा उपयोग किए जा सकने वाले प्रकार उपनाम परिभाषित करने के लिए @typedef का उपयोग करें।
/**
* @typedef {Object} User
* @property {string} id
* @property {string} name
* @property {boolean} isActive
*/
/** @type {User} */
const user = { id: "1", name: "Alice", isActive: true };जेनेरिक के लिए @template
जेएसडॉक में जेनेरिक फ़ंक्शन लिखने के लिए @template का उपयोग करें।
/**
* @template T
* @param {T[]} arr
* @returns {T | undefined}
*/
function first(arr) {
return arr[0];
}
// TypeScript infers: first<T>(arr: T[]): T | undefined.ts फ़ाइलों से प्रकार आयात करना
जेएसडॉक, JS फ़ाइलों में TypeScript प्रकार आयात करने के लिए @type {import("./types").User} का समर्थन करता है।
/** @type {import("./types").User} */
const admin = { id: "admin", name: "Admin", isActive: true };प्रति-फ़ाइल जाँच के लिए @ts-check
वैश्विक रूप से checkJs: true सक्षम किए बिना, केवल उसी फ़ाइल के लिए TypeScript जाँच चालू करने हेतु JS फ़ाइल के शीर्ष पर // @ts-check जोड़ें।
// @ts-check
/** @type {number} */
const count = "oops"; // Error: string not assignable to number@ts-ignore और @ts-expect-error
पूरी फ़ाइल को अक्षम किए बिना इनलाइन निर्देशों के माध्यम से विशिष्ट जेएसडॉक प्रकार-त्रुटियों को दबाएँ।
// @ts-ignore
const x = badFunction(); // single error suppressed
// @ts-expect-error
const y = anotherBad(); // error expected hereजेएसडॉक एनम
@enum का उपयोग करके जेएसडॉक में TypeScript एनम का अनुकरण करें।
/** @enum {string} */
const Direction = { Left: "left", Right: "right", Up: "up" };जेएसडॉक में प्रकार अभिकथन
जेएसडॉक प्रकार अभिकथन के लिए /** @type {SomeType} */ (expression) का उपयोग करें, जो TypeScript के as SomeType के समतुल्य है।
const el = /** @type {HTMLInputElement} */ (document.getElementById("input"));
el.value; // el: HTMLInputElement — typed.ts में कब जाएँ
जेएसडॉक एनोटेशन एक सेतु हैं, अंतिम लक्ष्य नहीं। जब कोई फ़ाइल पूरी तरह एनोटेट और स्थिर हो जाए, तो उसका नाम बदलकर .ts करें और मूल TypeScript सिंटैक्स के पक्ष में जेएसडॉक प्रकार-टिप्पणियाँ हटा दें।
// Rename: utils.js → utils.ts
// Replace JSDoc: /** @param {string} x */ → (x: string)पुनरावलोकन: सेतु के रूप में जेएसडॉक
जेएसडॉक प्रकार-एनोटेशन फ़ाइलों का नाम बदले बिना JS फ़ाइलों में TypeScript जाँच सक्षम करते हैं। मूल TypeScript में बदलने से पहले क्रमिक रूप से प्रकार-सुरक्षा जोड़ने के लिए @type, @param, @typedef और @template का उपयोग करें।
त्वरित जाँच
कौन-सा जेएसडॉक टैग वैश्विक checkJs के बिना किसी एक फ़ाइल में TypeScript जाँच सक्षम करता है?
आपने क्या सीखा
जेएसडॉक प्रकार-एनोटेशन JavaScript और TypeScript के बीच सेतु का काम करते हैं: JS फ़ाइलों में प्रकार जोड़ने के लिए @type, @param, @typedef और @template का उपयोग करें। // @ts-check से प्रति-फ़ाइल जाँच सक्षम करें, फिर तैयार होने पर मूल TypeScript में बदलें।
एआई शिक्षक के साथ TypeScript सीखें — निःशुल्क
अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।
- पाठ्यक्रम
- 101
- पाठ
- 352
अक्सर पूछे जाने वाले प्रश्न
क्या “पुल के रूप में JSDoc प्रकार एनोटेशन” पाठ निःशुल्क है?
हाँ—“पुल के रूप में JSDoc प्रकार एनोटेशन” का पूरा पाठ यहाँ वेब पर निःशुल्क पढ़ा जा सकता है। इंटरैक्टिव अभ्यास (अंतर्निहित कोड संपादक और 24/7 एआई ट्यूटर) करने और TypeScript Academy पाठ्यक्रम का बाकी हिस्सा अनलॉक करने के लिए CoddyKit PRO लें। TypeScript Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
“पुल के रूप में JSDoc प्रकार एनोटेशन” में मैं क्या सीखूँगा?
रूपांतरण से पहले JSDoc की सहायता से JS फ़ाइलों में प्रकार जोड़ें आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ TypeScript Academy का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।
क्या TypeScript Academy शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?
पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर TypeScript Academy शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 2वाँ पाठ है।
“पुल के रूप में JSDoc प्रकार एनोटेशन” पाठ पूरा करने में कितना समय लगता है?
CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।
क्या मैं इस TypeScript Academy पाठ में कोड लिख और चला सकता हूँ?
हाँ। हर TypeScript Academy पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।
इस पाठ्यक्रम के सभी पाठ
- माइग्रेशन शुरू करना: allowJs और checkJs
- पुल के रूप में JSDoc प्रकार एनोटेशन
- फ़ाइल-दर-फ़ाइल रूपांतरण रणनीति
- बिना प्रकार वाली तृतीय-पक्ष लाइब्रेरी से निपटना