डेवलपर टूल · URL एनकोडर और डिकोडर
URIError: URI विकृत - क्यों decodeURIComponent फेंकता है और इसे कैसे ठीक करें
· यह काम किस प्रकार करता है
URL एन्कोडिंग जावास्क्रिप्ट त्रुटि प्रबंधन
जब एक प्रतिशत चिह्न के बाद दो हेक्स अंक नहीं होते हैं, या जब डिकोड किए गए बाइट्स मान्य नहीं होते हैं तो decodeURIComponent फेंकता है UTF-8। यह पोस्ट उन इनपुट्स को दिखाती है जो इसे ट्रिगर करते हैं और रक्षात्मक रूप से डिकोड कैसे करें।
प्रतिशत चिह्न जो क्रैश हो गया - क्यों "100% छूट" decodeURIComponent को तोड़ता है
एक फ़ॉर्म “100% off” डिस्काउंट कोड लेता है। JavaScript इसे URL डिकोडर में decodeURIComponent को देता है। फ़ंक्शन URIError: URI malformed एरर फेंकता है। प्रतिशत चिह्न के बाद दो हेक्साडेसिमल अंक नहीं हैं, इसलिए यह प्रतिशत-एनकोडिंग के नियम पूरी तरह तोड़ता है। decodeURIComponent में हर % के बाद %20 या %C3 जैसा तीन-हिस्सों वाला कोड होना चाहिए। अकेला प्रतिशत चिह्न सिंटैक्स एरर है, जो प्रोसेस तुरंत रोककर एरर देता है।
इस त्रुटि को सुरक्षित रूप से पकड़ने से एप्लिकेशन क्रैश होने से पूरी तरह बच जाता है। URL उपयोगकर्ता इनपुट, रीडायरेक्ट, QR कोड और ईमेल से आते हैं। टाइपो त्रुटियाँ अक्सर होती रहती हैं। URIError के साथ एक क्रैश रिपोर्ट आपको बताती है कि कहां तुरंत जांच करनी है। रक्षात्मक डिकोडिंग से एप्लिकेशन चालू रहते हैं और त्रुटि लॉग डिबगिंग के लिए उपयोगी हो जाते हैं।
दो प्रकार की विफलता - विकृत हेक्स एस्केप और अमान्य UTF-8 बाइट अनुक्रम
decodeURIComponent ठीक दो स्थितियों में थ्रो होता है। पहला: विकृत पलायन अनुक्रम। एक प्रतिशत जिसके बाद दो हेक्स अंक (0-9, A-F, a-f) नहीं आते। उदाहरण: %ZZ, %2, %2g. दूसरा: वैध त्रिक जैसे %E9 को अमान्य UTF-8 बाइट्स में डिकोड करना। पहली है प्रारूप त्रुटि. दूसरी अर्थ संबंधी त्रुटि है. दोनों तुरंत फेंक देते हैं और निष्पादन रोक देते हैं।
UTF-8 में बाइट अनुक्रमों के बारे में सख्त नियम हैं। बाइट्स 0x80–0xFF केवल मल्टी-बाइट अनुक्रमों में दिखाई देते हैं। एक %E9 अकेले UTF-8 वैध नहीं हो सकता। यह अनाथ बाइट त्रुटि उत्पन्न करता है। प्रारूप त्रुटियाँ स्पष्ट हैं. शब्दार्थ संबंधी त्रुटियाँ सूक्ष्म लेकिन उतनी ही वास्तविक हैं। दोनों मामलों में उत्पादन कोड में प्रयास/catch हैंडलिंग की आवश्यकता होती है।
लीगेसी सिंगल-बाइट एन्कोडिंग - जब %E9 अकेले फेंकता है लेकिन %C3%A9 जीवित रहता है
भ्रम वेब मानकों के इतिहास से उत्पन्न होता है। पुराने पेजों में UTF-8 के बजाय लैटिन-1 का उपयोग किया गया। लैटिन में-1, %E9 को é दर्शाया गया है। आधुनिक ब्राउज़र विशेष रूप से UTF-8 का उपयोग करते हैं। UTF-8 é को %C3%A9 के रूप में एन्कोड करता है। आधुनिक डिकोडर UTF-8 की अपेक्षा करते हैं और %E9 को विकृत मानकर अस्वीकार कर देते हैं। यह सही व्यवहार है. त्रुटि स्रोत डेटा के साथ किसी समस्या का संकेत देती है।
आधुनिक सर्वसम्मति: UTF-8 हर जगह। URL मानक UTF-8 निर्दिष्ट करता है। सभी मौजूदा ब्राउज़र UTF-8 का उपयोग करते हैं। यदि आपको पुराने सिस्टम से %E9 का सामना करना पड़ता है, तो त्रुटि को पकड़ें और कच्ची स्ट्रिंग पर वापस जाएँ। आधुनिक कोड में लैटिन-1 के रूप में डिकोड न करें। जांच करें कि डेटा कहां से उत्पन्न हुआ।
तीन इनपुट, तीन त्रुटि संदेश - एक ही टूटी हुई स्ट्रिंग पर इंजन कैसे भिन्न होते हैं
ब्राउज़र इंजन लगातार विकृत इनपुट को अस्वीकार करते हैं लेकिन शब्द त्रुटियां अलग-अलग होती हैं। Chrome रिपोर्ट करता है "URI विकृत"। फ़ायरफ़ॉक्स "विकृत URI अनुक्रम" की रिपोर्ट करता है। सफ़ारी रिपोर्ट "अपरिभाषित को ऑब्जेक्ट में परिवर्तित नहीं कर सकती"। तीनों इंजन समान इनपुट को अस्वीकार करते हैं। सटीक संदेश शब्दांकन विभिन्न इंजनों या संस्करणों में मानकीकृत नहीं है। कोड तर्क का मार्गदर्शन करने के लिए कभी भी त्रुटि पाठ पर भरोसा न करें।
प्रोग्राम निर्णयों के लिए कभी भी त्रुटि संदेश को स्ट्रिंग-मैच न करें। हमेशा URIError को प्रकार के अनुसार पकड़ें। DecodeUrl फ़ंक्शन decodeURIComponent को लपेटता है और सुसंगत कोड INVALID_PERCENT_ENCODING प्रदान करता है। यह सटीक समस्या स्थिति का नाम देता है. यह सभी रनटाइम पर काम करता है क्योंकि यह इंजन शब्दों की विविधता पर निर्भर नहीं करता है। यह दृष्टिकोण अधिक विश्वसनीय और रखरखाव योग्य है।
अपवाद को सुरक्षित रूप से पढ़ना - प्रयास करें/catch, सत्यापन, और फ़ॉलबैक पैटर्न
सबसे सरल रक्षात्मक पैटर्न: decodeURIComponent को Try/catch. में लपेटें यदि यह फेंकता है, तो कच्ची स्ट्रिंग या प्रतिस्थापन वर्ण का उपयोग करें। यह विकृत इनपुट को क्रैश होने से बचाता है। क्वेरी मानों के लिए, URL-एनकोडेड फॉर्म दिखाएं। उपयोगकर्ता-सामना वाले पाठ के लिए, प्रतिस्थापन वर्ण डालें। यह खराब इनपुट को एप्लिकेशन को टूटने से बचाता है और स्थिरता बनाए रखता है।
गति और सुरक्षा के लिए नियमित अभिव्यक्तियों के साथ पूर्व-सत्यापन करें। डिकोडिंग से पहले जांचें कि इनपुट में केवल वैध %XX ट्रिपलेट्स हैं। पैटर्न /%[0-9A-Fa-f]{2}/g वैध पलायन पकड़ता है; कुछ भी बेजोड़ अमान्य है. स्पष्ट कचरे पर प्रारूप त्रुटियाँ तेजी से विफल हो जाती हैं। UTF-8 त्रुटियों को अभी भी प्रयास की आवश्यकता है/catch. साथ में यह त्रुटियों के विरुद्ध व्यापक रक्षात्मक सुरक्षा प्रदान करता है।
साइलेंट विफलताएं बग छिपाती हैं - क्यों ब्लाइंड डिकोडिंग टूटी एन्कोडिंग जितनी जोखिम भरी है
सूक्ष्म जोखिम: डिकोडर फेंकता नहीं है बल्कि चुपचाप गलत टेक्स्ट उत्पन्न करता है। अप्रचलित अनस्केप का उपयोग करने वाला पुराना कोड स्मृति में अमान्य UTF-8 छोड़ देता है। UTF-8 को सख्ती से मान्य करने वाले सिस्टम तक पहुंचने तक टेक्स्ट स्क्रीन पर ठीक दिखता है। आधुनिक कोड चुपचाप भ्रष्ट होने के बजाय फेंक देता है। डाउनस्ट्रीम में फैल रहे मूक डेटा भ्रष्टाचार की तुलना में एक अपवाद अधिक स्पष्ट और सुरक्षित है।
मान लें कि उपयोगकर्ता इनपुट विकृत है। हमेशा कॉल लपेटें. डिबगिंग के लिए मूल इनपुट के साथ त्रुटियों को लॉग करें। यह कभी न मानें कि प्रत्येक % वैध है। टाइपो और ट्रंकेशन अपूर्ण पलायन बनाते हैं। इसे डेटा त्रुटियों के रूप में मानें, तर्क त्रुटियों के रूप में नहीं। रक्षात्मक कोड खराब इनपुट को शानदार ढंग से झेलता है और सिस्टम को विश्वसनीय बनाए रखता है।
वास्तविक टूल क्या छोड़ते हैं - सर्वर-साइड फ्रेमवर्क व्यवहार और त्रुटि पुनर्प्राप्ति
सर्वर फ़्रेमवर्क ब्राउज़र की तुलना में विकृत एन्कोडिंग को अधिक उदारता से संभालते हैं। रूबी, पायथन और PHP URL में अमान्य एस्केप से निपटने के लिए कॉन्फ़िगरेशन प्रदान करते हैं। कुछ स्थानापन्न प्रतिस्थापन वर्ण स्वचालित रूप से। अन्य लोग चुपचाप बाइट छोड़ते हैं। कुछ लोग JavaScript जैसे अपवाद फेंकते हैं। वास्तविक व्यवहार डेवलपर्स द्वारा चुनी गई रूपरेखा और कॉन्फ़िगरेशन सेटिंग्स के अनुसार भिन्न होता है।
यह आलेख केवल ब्राउज़र JavaScript व्यवहार को कवर करता है। यदि मान सर्वर APआई से आते हैं, तो सर्वर भेजने से पहले ही त्रुटियों को डीकोड या छोड़ देता है। सर्वर ग्राहकों की तुलना में अधिक क्षमाशील हो सकते हैं। API अनुबंध लिखते समय, निर्दिष्ट करें कि मान कच्चे हैं या पूर्व-डिकोडेड हैं। URL क्वेरी स्ट्रिंग्स प्रतिशत-एन्कोडेड आनी चाहिए; JSON पूर्व-डिकोडेड आ सकता है।
शीघ्र सत्यापन करें - पहले संदिग्ध स्ट्रिंग्स की जांच करने के लिए URL एनकोडर और डिकोडर का उपयोग करें
संदिग्ध URL को DecodeURIComponent में भेजने से पहले, URL एनकोडर और डिकोडर में पेस्ट करें। टूल सटीक एन्कोडिंग दिखाता है, विकृत एस्केप का पता लगाता है और आपके एप्लिकेशन को क्रैश किए बिना त्रुटियों की व्याख्या करता है। विभिन्न विफलताओं और उनके सटीक त्रुटि संदेशों को देखने के लिए %ZZ, %E9 और 100% के साथ परीक्षण करें। इसमें कुछ सेकंड लगते हैं और आत्मविश्वास बढ़ता है।
शीघ्र सत्यापन करें, त्रुटियों को शालीनता से पकड़ें और जो टूटा, उसे लॉग करें। रक्षात्मक डिकोडर प्लस परीक्षण टूल अनुप्रयोगों को चालू और डिबग करने योग्य रखता है। URL एनकोडर और डिकोडर "URI विकृत" को कार्रवाई योग्य जानकारी में बदल देता है जिसे आप तुरंत उपयोग कर सकते हैं। उत्पादन परिवेश में लचीलेपन और रखरखाव के लिए इस पैटर्न को अपने स्वयं के डिकोडर्स पर लागू करें।