अर्धविराम के संबंध में जेएस नेताओं को खुला पत्र

मुझे कल रात शॉन सिल्वा का यह पत्र मिला:

मैं आपके कोड के माध्यम से npm.js प्रोजेक्ट के लिए देख रहा था (विशेष रूप से, यह फ़ाइल: https://github.com/isaacs/npm/blob/master/lib/npm.js ) और देखा कि आप कॉमा को 'r' से जोड़ रहे हैं मामले में और [और {शाब्दिक में सरणियों / वस्तुओं के तहत 'वर। मैं वास्तव में इस प्रारूपण पद्धति को पसंद करता हूं, लेकिन मैं इसका उपयोग करने में संकोच करता हूं, क्योंकि js के बारे में अधिकांश संसाधन अराजकता का डर पैदा करते हैं जो स्वचालित अर्धविराम के कारण कोड में शासन करता है यदि आप किसी भी चीज़ के साथ लाइनों को समाप्त नहीं करते हैं जो सुझाव देते हैं शेष भाग।
क्या इस तरह से "ब्राउज़र" कोड में अल्पविराम लगाना सुरक्षित है, या क्या यह केवल नोड में संभव है?

मैंने कुछ पैराग्राफ लिखे और निम्नलिखित उत्तर के लिए उन्हें छोटा करने का निर्णय लिया:

हां, यह पूरी तरह से सुरक्षित है, और यह पूरी तरह से वैध जेएस है, जिसे हर ब्राउज़र द्वारा समझा जाता है। क्लोजर कंपाइलर, युकोमप्रेसर, पैकर, और जैस्मीन - सभी इसे ठीक से मिनिमाइज कर सकते हैं। प्रदर्शन कहीं नहीं चल रहा है।
मुझे खेद है कि आपको पढ़ाने के बजाय, इस भाषा में समुदाय के नेताओं ने आपको झूठ और भय में प्रेरित किया। यह एक शर्म की बात है। मेरा सुझाव है कि आप अध्ययन करें कि जेएस के निर्देशों को वास्तव में कैसे समाप्त किया जाता है (और किन मामलों में उन्हें समाप्त नहीं किया गया है) - और आप कोड लिख सकते हैं जो आपको सुंदर लगते हैं।

इनिमिनो ने बहुत स्पष्ट स्पष्टीकरण पोस्ट किया। उनकी शैली में - अच्छे शोध के साथ स्पष्ट, संक्षिप्त, आधिकारिक, और उन्होंने हमेशा की तरह, अपनी राय खुद पर छोड़ दी।
मैं थोड़ा और पक्षपाती होने जा रहा हूं।

नियम

सामान्य तौर पर, \n हमेशा निम्नलिखित मामलों को छोड़कर, भावों को समाप्त करता है:

• एक अभिव्यक्ति एक असंगत कोष्ठक, एक सरणी शाब्दिक, एक वस्तु शाब्दिक, या किसी अन्य तरीके से समाप्त होती है जो एक अभिव्यक्ति को बंद करने का कानूनी तरीका नहीं है (उदाहरण के लिए, समाप्त होता है . या;)।
• स्ट्रिंग है -- , ++ (इस घटना में कि अगला टोकन घटाया / बढ़ा हुआ है);
• यह for() , while() , do , if() , या, और कोई {
• अगली पंक्ति [ , ( , + , * , / , - ,,,, या किसी भी बाइनरी ऑपरेटर से शुरू होती है जो केवल दो टोकन के बीच एक अभिव्यक्ति में हो सकती है।

पहला नियम बहुत स्पष्ट है। यहां तक ​​कि JSLint को JSON में, कोष्ठक निर्माण में, और var अभिव्यक्तियों में समाप्त होने वाली var अभिव्यक्तियों में बुरा नहीं लगता है।
दूसरा बहुत अजीब है। मैं किसी के लिए i\n++\nj लिखने के लिए ऐसी चीजों (इस प्रकार की बातचीत के अपवाद के साथ) से कभी नहीं मिला, लेकिन वास्तव में, यह i; ++j पसंद है i; ++j i; ++j , i++; j तरह नहीं i++; j i++; j
तीसरा अच्छी तरह से समझा जाता है, हालांकि वे आमतौर पर उपेक्षित होते हैं: if (x)\ny() if (x) { y() } बराबर है। यह निर्माण तब तक समाप्त नहीं होता है जब तक कोई ब्लॉक या अभिव्यक्ति सामने नहीं आती है। ; एक मान्य जावास्क्रिप्ट अभिव्यक्ति है, इसलिए if(x); if(x){} या "यदि x, तो कुछ भी नहीं।" के बराबर है। यह आमतौर पर लूप पर लागू होता है जिसमें चेक करना भी काउंटर के लिए एक अद्यतन है। असामान्य, लेकिन पाया गया।
चौथा, आमतौर पर FUD- प्रेरित, "अरे नहीं, आपको अर्धविराम की आवश्यकता है!" मामला है। लेकिन यह पता चला है कि अर्धविराम के साथ ऐसी रेखाओं को पूर्ववर्ती करना काफी सरल है, यदि आप उन्हें पिछले वाले एक्सटेंशन नहीं बनाना चाहते हैं।
उदाहरण के लिए, इसके बजाय:

 foo(); [1,2,3].forEach(bar); 

लिख सकते हैं:

 foo() ;[1,2,3].forEach(bar) 

लाभ यह है कि उपसर्गों को नोटिस करना आसान है क्योंकि आप कभी भी ( या अर्धविराम के बिना) लाइन शुरू नहीं करने का निर्णय लेते हैं।

सीमित नियम

अर्धविराम के लिए एक और मानक तर्क एआईएस और प्रतिबंधित नियमों के साथ करना है। उदाहरण के लिए, यदि आपके पास टोकन return तुरंत बाद \n , तो पोस्टफिक्स फॉर्म में throw , continue , या ++ या -- (उदाहरण के लिए, x++\n या y--\n ), तो यह अभिव्यक्ति को समाप्त कर देगा - बिना किसी अपवाद के ।

 // return 7 //,  return 7 

और फिर से: इसके बावजूद, जैसे ही आप प्रत्येक अभिव्यक्ति को अर्धविराम के साथ पूरा करना भूल जाते हैं, ऐसी चीज़ों को देखना और रोकना आसान होता है । जब मैं दूसरा नियम पूरा करता हूं, तो मेरा मस्तिष्क सहज रूप से \n सी "ठीक है, यह है", क्योंकि return को समाप्त करने के लिए, केवल एक पंक्ति फ़ीड हमेशा पर्याप्त है।
स्क्रीन के बाईं ओर सबसे महत्वपूर्ण टोकन संरेखित करना लोगों को जल्दी से विश्लेषण करने के लिए उन्हें स्पष्ट रूप से आसान बनाता है। त्वरित पढ़ने के अध्ययन और आंखों के आंदोलनों के ढेर का दावा है कि दाईं ओर एक टोकन गुम होने से बाईं ओर एक लापता टोकन की तुलना में अनदेखी की संभावना अधिक है। इसलिए - मैं दोहराता हूं - कम महत्वपूर्ण चीजों को दाईं ओर ले जाएं, और अधिक महत्वपूर्ण चीजों को बाईं ओर रखें।

तो कौन सा स्टाइल बेहतर है?

इस हद तक कि "सर्वश्रेष्ठ शैली" वस्तुनिष्ठ रूप से मौजूद है, यह मुझे प्रतीत होता है कि "अर्धविराम / अल्पविराम पहले" शैली थोड़ी बेहतर है; दो कारणों से: क्योंकि यह शैली बेहतर पठनीय है और क्योंकि यह डेवलपर्स को उस भाषा को बेहतर ढंग से समझने के लिए प्रोत्साहित करती है जिसका वे उपयोग करते हैं।
मैं इस बात की गारंटी दे सकता हूं कि इससे कोई फर्क नहीं पड़ता कि यह आपको कितना कम परेशान करता है, आपका जेएस कोड आपको मेरी परवाह करने से कम चिंतित करता है। यह एक लेख नहीं है जहां मैं आपको अपनी शैली में कोड लिखने के लिए मनाने की कोशिश करता हूं। हर किसी को यह तय करना होगा कि उसके घर में पैंट पहनने की नीति क्या है ।
सद्भावना की अभिव्यक्ति के रूप में ...

अर्धविराम लगाने के अच्छे कारण

अर्धविराम के अति प्रयोग के कारण सौंदर्यशास्त्र और राजनीति हैं।
"मैं जेएस में अर्धविराम लगाता हूं, क्योंकि अन्यथा यह सी / सी ++ / जावा / कुछ भी मान्य नहीं होगा।" यदि आप एक परियोजना में बहुत सारे जावा या सी कोड लिखने के लिए मजबूर हैं और चाहते हैं कि आपका जेएस बहुत अधिक बाहर खड़ा न हो, तो यह एक योग्य तर्क है। ( कैसिस परियोजना इस तर्क को एक बेतुके निष्कर्ष पर ले जाती है।)
"हम ऐसा इसलिए करते हैं क्योंकि हम लिंटर का उपयोग करते हैं, और लिंटर इसे ऑर्डर करता है।" संगति महत्वपूर्ण है, और लिंटर एक समूह के लिए कोड स्थिरता प्राप्त करने का एक तरीका है। एनपीएम-संगत लिंटर लिखने का कार्य मेरी टूडू सूची में है, लेकिन बहुत अधिक नहीं है।

अर्धविराम के साथ सबसे खराब चीजें

"वे आवश्यक हैं क्योंकि एएसआई अविश्वसनीय है।" ओह, चलो ??
ये नियम 90 के दशक के अंत तक जेएस की सुबह तक चले जाते हैं। वे नए नहीं हैं, और मेरी राय यह है कि जेएस में खुद को पेशेवर कहने वाले को कोई माफी नहीं है और अभिव्यक्ति को समाप्त करने के नियम को नहीं समझता है। यह जेएस समुदाय के नेताओं के लिए समझ के बजाय अश्लीलता फैलाना जारी रखता है।
इसके अलावा, विशिष्ट स्थान जहां एआईएस चुपके से हमला करता है, सीमित नियम हैं। प्रत्येक पंक्ति में अर्धविराम जोड़ना undefined अलावा और कुछ भी वापस return\nfoo रिटर्न return\nfoo मजबूर नहीं करेगा। समस्या यह है कि आप लाइन फीड का उपयोग कर रहे हैं और यह नहीं कि आप अर्धविराम नहीं लगा रहे हैं।
सीमित नियमों के साथ त्रुटियों को स्थायी रूप से रोकने का एकमात्र तरीका हमेशा अर्धविराम का उपयोग करना है और कभी भी लाइन ब्रेक नहीं लगाना है । यह कोई प्रदान नहीं करता है। इसलिए इसके बारे में बात करना बंद करें जैसे कि यह मायने रखता है, या एएसआई को समझने के विकल्प के रूप में निरर्थक अर्धविराम का सुझाव देता है। एक सक्षम जेएस प्रोग्रामर, अवधि होने के लिए आपको एएसआई को समझना चाहिए।
और यह हमें ...

मैं सभी पक्षपाती हो गया हूं और आपको बदनाम कर रहा हूं (इसके विपरीत प्रयास करने के बावजूद)

यदि आप यह नहीं समझते हैं कि जेएस में अभिव्यक्तियों को कैसे समाप्त किया जाता है, तो आप बस जेएस को ठीक से नहीं जानते हैं, और आपको जेएस के पर्यवेक्षण के बिना पेशेवर नहीं लिखना चाहिए, और निश्चित रूप से इसे लिखने के बारे में सलाह नहीं देनी चाहिए।
मुझे लगता है कि मैंने सिर्फ आपका अपमान किया है। बहुत बुरा। मुझे पता है कि आप JS के बारे में बहुत कुछ जानते हैं - जैसे DOM, और CSS, और MSIE बग और jQuery। आपने शायद कुछ समय क्लोजर, और प्रोटोटाइप, और स्कोप, और एक्टिवेशन ऑब्जेक्ट्स का अध्ययन करने में बिताया, और यहां तक ​​कि वी 8 या स्पाइडरमोंकी के लिए कुछ एक्सटेंशन भी लिखे। तुम बेवकूफ नहीं हो, मुझे यकीन है। वास्तव में, आप मेरी तुलना में सबसे अधिक होशियार हैं, और आप शायद अच्छे हैं और बेहतर दिख रहे हैं। मुझे यकीन है कि हमारे पास बहुत कुछ है, और हम दोस्त हो सकते हैं।
लेकिन अगर आपको यह समझ में नहीं आता है कि जेएस में एक अभिव्यक्ति क्या है , तो आपकी समझ में कि भाषा का सबसे बुनियादी पहलू क्या है - एक बड़ा छेद।
और यह सामान्य है। मैं स्पैनिश बहुत अच्छी तरह से नहीं बोलता हूं और मेरी सी आम तौर पर शुरुआती स्तर पर है; और मैं इन चीजों में खुद को विशेषज्ञ नहीं कहता, हालांकि मैं ज्यादातर स्थितियों में बाहर निकलने के लिए पर्याप्त जानता हूं। अगर मैं काम करने जा रहा था, जो स्पैनिश या सी की बहुत सारी बातचीत का तात्पर्य है, तो मैं चाहूंगा कि कुछ गंभीर गलतियों से बचने के लिए कोई मेरी देखभाल करे।
जेएस में अधिकांश चीजों की तरह, अभिव्यक्ति समाप्ति नियम अच्छी तरह से डिज़ाइन नहीं किए गए हैं, लेकिन उन्हें समझना और उपयोग करना बहुत मुश्किल नहीं है । इस समझ में बस थोड़ा समय और प्रयास लगता है।
कुछ शनिवार की रात को हॉट चॉकलेट और ईसीएमएस्क्रिप्ट की कल्पना के साथ वापस बैठें। इसका अभ्यास करें। परीक्षण कार्यक्रमों के साथ खेलते हैं। यह एक अच्छा शगल है।
या यदि आप नहीं चाहते हैं तो ऐसा न करें। यह तुम्हारा जीवन है। निश्चित रूप से आपके पास बेहतर कक्षाएं हैं।
बस आधिकारिक बयान देना बंद कर दें जैसे "अर्धविराम के साथ सभी लाइनें सुरक्षित रहें।" यह सुरक्षित नहीं है और सुरक्षित नहीं है।

अनुपूरक 1: नेता

तो, मिस्टर आयरन-ऑन-अगेंस्ट-वूल, ये "नेता" आप किसके बारे में बात कर रहे हैं? आप नाम क्यों नहीं बताते?

क्योंकि उनमें से बहुत सारे हैं, और मैं उन सभी को नहीं जानता।
यदि आपने जेएस पर कुछ समय के लिए लिखा है, और सलाह दें या किसी ऐसे व्यक्ति का नेतृत्व करें जिसके पास कम अनुभव है, तो मैं आपसे संपर्क करूंगा। एक नेता होना एक जिम्मेदारी है। इसे गंभीरता से लें। झूठ न फैलाएं। एक विशेषज्ञ बनें, या स्वीकार करें कि आप नहीं हैं। लेकिन बिना लाइसेंस के इस कार को न चलाएं।

परिशिष्ट 2: साक्षरता प्रोग्रामिंग के अनुयायी

(अनुवादक का नोट: साहित्यिक प्रोग्रामिंग का मतलब है)

लेकिन अंग्रेजी में हम अंत में विराम चिह्न लगाते हैं, शुरुआत में नहीं।

जावास्क्रिप्ट अंग्रेजी नहीं है। हम भी अंग्रेजी में एक डॉट के साथ कब्जे (या वस्तु-क्रिया संबंध) को निरूपित नहीं करते हैं। अंग्रेजी में कोई वस्तु शाब्दिक नहीं हैं, और हम केवल एक अनुच्छेद की पहली पंक्ति का संकेत देते हैं, और सभी वाक्यों का नहीं।
यह इतना मूर्खतापूर्ण तर्क है कि मेरे पास उसके साथ प्यार में पड़ने के अलावा कोई विकल्प नहीं है।
मैंने आपका अपमान करना शुरू किया, लेकिन आपने मेरा दिल जीत लिया, एडेप्ट ऑफ लिटरेट प्रोग्रामिंग। अब से, मैं केवल फ़ंक्शंस के अंत में लाइन फीड लगाऊंगा, बीच में नहीं और उनमें से प्रत्येक की पहली पंक्ति पर इंडेंट।

अनुपूरक 3: पैदल सेना

आपको मेरे कोड में क्या मिलेगा? आप पेडेंट गैलरी चुनते हैं?

जैसा आप चाहें कोड लिखें। मुझे कुछ नहीं करना है।
बस कृपया लोगों से झूठ मत बोलो। यही सब मैं पूछता हूं। यह बस थोड़ा सा शिष्टाचार है। यह मुश्किल नहीं है। केवल झूठ बोलने के बजाय सच्चाई बताएं - कि मैं किस बारे में बात कर रहा हूं।

(अनुवादक से: एक अनुवादक के रूप में, मैं अपनी प्रिय महिला - एक दार्शनिक) को अनुवाद और प्रूफ-रीडिंग के साथ मदद के लिए अपना आभार व्यक्त करना चाहता हूं