Jest: डॉक्स और उदाहरणों में असंगति

पीआर #3172 ने वादों पर दावे चलाने के लिए नए .resolves और .rejects कीवर्ड को शामिल करने के लिए डॉक्स को अपडेट किया।

मैंने देखा कि इस पीआर ने https://github.com/facebook/jest/blob/master/docs/TutorialAsync.md के अपडेटेड एरर हैंडलिंग सेक्शन में कुछ विसंगतियां पेश की हैं

1. परीक्षण के शीर्ष पर टिप्पणियां अभी भी try-catch को संदर्भित करती हैं, यह कोड स्निपेट में निहित कोड के साथ असंगत है।
2. पीआर केवल .rejects साथ एक उदाहरण दिखाता है जो केवल जेस्ट 20+ में उपलब्ध होगा। भ्रम से बचने के लिए डॉक्स में इसका उल्लेख किया जाना चाहिए।
3. जेस्ट के पुराने संस्करणों का उपयोग करने वाले लोग इस दस्तावेज़ का उपयोग नहीं कर पाएंगे। मुझे लगता है कि हमें try-catch का उपयोग करने के बारे में स्पष्टीकरण को वापस जोड़ना चाहिए ताकि Jest 19 और उससे कम का उपयोग करने वाले लोगों के लिए प्रॉमिस रिजेक्शन (जिसे PR #3172 में हटा दिया गया) को पकड़ सके। यह .rejects का उपयोग करके वर्तमान दस्तावेज़ों के साथ रह सकता है।
4. लिंक में निहित उदाहरण examples/async इस तरह के परीक्षण उदाहरणों से लिंक करता है। ये उदाहरण अभी भी try-catch तंत्र का उपयोग करते हैं, यह वर्तमान में दस्तावेज़ों में निहित कोड उदाहरणों के साथ असंगत है। यह एक और कारण है कि हमें दस्तावेज़ों के इस खंड में try-catch का उपयोग करने के स्पष्टीकरण को वापस जोड़ना चाहिए।