Widget नियम: साइज़, परफ़ॉर्मेंस लिमिट और चेक कोड
साइज़, फ़ाइल टाइप, परफ़ॉर्मेंस लिमिट और हर वह कोड जिससे चेक फ़ेल हो सकता है।
widget overlay में बाकी सब चीज़ों के साथ चलता है, अक्सर धीमे PCs पर। इसलिए तय लिमिट लागू होती हैं। Livedeck यही नंबर तीन जगह इस्तेमाल करता है: यहाँ docs में, अप्रूवल से पहले के ऑटोमैटिक टेस्ट में और LIVE के दौरान overlay में।
पैकेज
ZIP फ़ाइल
5 MB
अनपैक करने पर कुल
5 MB
एक फ़ाइल
2 MB
फ़ाइलें
200
Path की लंबाई
180 अक्षर
फ़ोल्डर की गहराई
8
manifest.json
64 KB
| लिमिट | वैल्यू |
|---|---|
| ZIP फ़ाइल | 5 MB |
| अनपैक करने पर कुल | 5 MB |
| एक फ़ाइल | 2 MB |
| फ़ाइलें | 200 |
| Path की लंबाई | 180 अक्षर |
| फ़ोल्डर की गहराई | 8 |
| manifest.json | 64 KB |
अनुमत फ़ाइल टाइप: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. टेक्स्ट फ़ाइलें UTF-8 में होनी चाहिए। तस्वीरें, आवाज़ें और fonts असल में वही होने चाहिए जो उनका extension बताता है।
क्या अनुमत नहीं है
- HTML, CSS, JavaScript, SVG या JSON में दूसरी साइट्स के एड्रेस (http://, https://, ws://, wss:// या //host)। comments में एड्रेस से चेक फ़ेल नहीं होता, लेकिन admin उन्हें देखता है।
- HTML में iframe, frame, object, embed, portal, base और meta refresh
- WebRTC (RTCPeerConnection, STUN या TURN servers), JavaScript से frames (createElement("iframe") या strings में "<iframe") और dns-prefetch या preconnect जैसे connection hints. Livedeck इन features को widget के अंदर बंद भी कर देता है।
- SVG फ़ाइलों में scripts, event handlers या foreignObject
- एन्क्रिप्टेड ZIP फ़ाइलें, symbolic links और archive के अंदर archives
admin को eval, new Function, WebAssembly, WebSockets, storage या overlay window तक पहुँच, mining patterns और obfuscated या minified कोड के hints भी दिखते हैं। hints से चेक तुरंत फ़ेल नहीं होता, लेकिन इनके लिए ठोस वजह चाहिए। minified कोड के साथ src/ फ़ोल्डर में पढ़ने लायक sources भी दें।
manifest.json, src/ फ़ोल्डर और .md या .txt फ़ाइलें सिर्फ़ review के लिए हैं। Livedeck इन्हें कभी overlay को नहीं देता, इसलिए आपका कोड इन्हें लोड नहीं कर सकता। हर यूज़र को आपका widget उसके अपने एड्रेस पर मिलता है।
परफ़ॉर्मेंस लिमिट
पेज लोड होने के बाद तैयार
3000 ms
LIVE के दौरान पेज लोड होना
15,000 ms
बिना events के CPU (औसत)
2 %
बहुत ज़्यादा events के साथ CPU (औसत)
15 %
मेमोरी (JavaScript)
64 MB
पेज पर एलिमेंट
3000
एक बार में सबसे लंबा ब्लॉक
200 ms
| माप | लिमिट |
|---|---|
| पेज लोड होने के बाद तैयार | 3000 ms |
| LIVE के दौरान पेज लोड होना | 15,000 ms |
| बिना events के CPU (औसत) | 2 % |
| बहुत ज़्यादा events के साथ CPU (औसत) | 15 % |
| मेमोरी (JavaScript) | 64 MB |
| पेज पर एलिमेंट | 3000 |
| एक बार में सबसे लंबा ब्लॉक | 200 ms |
LIVE के दौरान
- overlay हर 2000 ms पर चेक करता है। लगातार 3 जवाब 1000 ms से धीमे हों, या 6000 ms तक कोई जवाब न आए, तो widget बंद हो जाता है।
- अगर overlay खुद अटका हुआ था (जैसे tab background में होने की वजह से), तो इसे कभी आपके widget के ख़िलाफ़ नहीं गिना जाता।
- जो widget बंद कर दिया गया था, वह अगले reload तक बंद ही रहेगा। इसके बाद editor में "Widget रुक गया" दिखेगा।
जाँच कोड
जाँच फ़ेल होने पर editor या seller studio कारणों की सूची दिखाता है। यहाँ हर कोड दिया गया है।
ZIP फ़ाइल
zip_too_large
ZIP फ़ाइल 5 MB से बड़ी है।
zip_total_too_large
Unpack करने के बाद 5 MB से बड़ी है।
zip_file_too_large
कोई फ़ाइल 2 MB से बड़ी है।
zip_too_many_files
200 से ज़्यादा फ़ाइलें।
zip_not_zip
ZIP फ़ाइल नहीं है, या खाली है।
zip_multi_disk
कई हिस्सों में बँटी है। सब कुछ एक ही फ़ाइल में पैक करें।
zip64_unsupported
ZIP64 सपोर्टेड नहीं है।
zip_trailing_data
ZIP फ़ाइल के अंत के बाद अतिरिक्त डेटा है।
zip_corrupt
ZIP फ़ाइल खराब है।
zip_encrypted
ZIP फ़ाइल पासवर्ड से सुरक्षित है।
zip_unsupported_method
यह compression method सपोर्टेड नहीं है। Stored (बिना compression) और Deflate (डिफ़ॉल्ट) की अनुमति है।
zip_header_mismatch
Archive में आपस में विरोधी जानकारी है।
zip_overlap
Archive के अंदर फ़ाइलें एक-दूसरे पर overlap करती हैं।
zip_crc_mismatch
Checksum गलत है, कोई फ़ाइल खराब है।
zip_symlink
पैकेज में symbolic link है।
zip_bad_name
अमान्य फ़ाइल नाम: UTF-8 के बिना non-ASCII, ../, absolute paths, विशेष अक्षर, 180 अक्षरों से लंबा या 8 फ़ोल्डर से ज़्यादा गहराई।
zip_duplicate_name
Archive में एक फ़ाइल दो बार है।
zip_nested_archive
Archive के अंदर archive (जैसे ZIP के अंदर ZIP)।
| कोड | मतलब |
|---|---|
| zip_too_large | ZIP फ़ाइल 5 MB से बड़ी है। |
| zip_total_too_large | Unpack करने के बाद 5 MB से बड़ी है। |
| zip_file_too_large | कोई फ़ाइल 2 MB से बड़ी है। |
| zip_too_many_files | 200 से ज़्यादा फ़ाइलें। |
| zip_not_zip | ZIP फ़ाइल नहीं है, या खाली है। |
| zip_multi_disk | कई हिस्सों में बँटी है। सब कुछ एक ही फ़ाइल में पैक करें। |
| zip64_unsupported | ZIP64 सपोर्टेड नहीं है। |
| zip_trailing_data | ZIP फ़ाइल के अंत के बाद अतिरिक्त डेटा है। |
| zip_corrupt | ZIP फ़ाइल खराब है। |
| zip_encrypted | ZIP फ़ाइल पासवर्ड से सुरक्षित है। |
| zip_unsupported_method | यह compression method सपोर्टेड नहीं है। Stored (बिना compression) और Deflate (डिफ़ॉल्ट) की अनुमति है। |
| zip_header_mismatch | Archive में आपस में विरोधी जानकारी है। |
| zip_overlap | Archive के अंदर फ़ाइलें एक-दूसरे पर overlap करती हैं। |
| zip_crc_mismatch | Checksum गलत है, कोई फ़ाइल खराब है। |
| zip_symlink | पैकेज में symbolic link है। |
| zip_bad_name | अमान्य फ़ाइल नाम: UTF-8 के बिना non-ASCII, ../, absolute paths, विशेष अक्षर, 180 अक्षरों से लंबा या 8 फ़ोल्डर से ज़्यादा गहराई। |
| zip_duplicate_name | Archive में एक फ़ाइल दो बार है। |
| zip_nested_archive | Archive के अंदर archive (जैसे ZIP के अंदर ZIP)। |
फ़ाइलें और कंटेंट
manifest_missing
manifest.json नहीं मिली। यह ZIP के सबसे ऊपर या उसके इकलौते फ़ोल्डर के अंदर होनी चाहिए।
manifest_invalid
manifest.json अमान्य है। गलतियाँ उसके नीचे दी गई हैं (कोड "manifest.json reference" में)।
entry_missing
entry में बताई गई start फ़ाइल पैकेज में नहीं है।
file_type_not_allowed
इस फ़ाइल टाइप की अनुमति नहीं है।
file_content_mismatch
कंटेंट extension से मेल नहीं खाता (जैसे .png नाम वाली JPG)।
file_not_utf8
टेक्स्ट फ़ाइल UTF-8 में सेव नहीं है।
file_empty
फ़ाइल खाली है।
external_reference
फ़ाइल में किसी दूसरी साइट का पता है (लाइन के साथ)।
forbidden_markup
ऐसा HTML जिसकी अनुमति नहीं है (iframe, frame, object, embed, portal, base, meta refresh) या SVG फ़ाइल में script।
forbidden_api
ऐसा कोड जो नेटवर्क की रोक को बायपास करे: WebRTC (RTCPeerConnection, STUN/TURN), JavaScript से frames (createElement("iframe"), strings में "<iframe") या connection hints (dns-prefetch, preconnect, prerender, prefetch)।
| कोड | मतलब |
|---|---|
| manifest_missing | manifest.json नहीं मिली। यह ZIP के सबसे ऊपर या उसके इकलौते फ़ोल्डर के अंदर होनी चाहिए। |
| manifest_invalid | manifest.json अमान्य है। गलतियाँ उसके नीचे दी गई हैं (कोड "manifest.json reference" में)। |
| entry_missing | entry में बताई गई start फ़ाइल पैकेज में नहीं है। |
| file_type_not_allowed | इस फ़ाइल टाइप की अनुमति नहीं है। |
| file_content_mismatch | कंटेंट extension से मेल नहीं खाता (जैसे .png नाम वाली JPG)। |
| file_not_utf8 | टेक्स्ट फ़ाइल UTF-8 में सेव नहीं है। |
| file_empty | फ़ाइल खाली है। |
| external_reference | फ़ाइल में किसी दूसरी साइट का पता है (लाइन के साथ)। |
| forbidden_markup | ऐसा HTML जिसकी अनुमति नहीं है (iframe, frame, object, embed, portal, base, meta refresh) या SVG फ़ाइल में script। |
| forbidden_api | ऐसा कोड जो नेटवर्क की रोक को बायपास करे: WebRTC (RTCPeerConnection, STUN/TURN), JavaScript से frames (createElement("iframe"), strings में "<iframe") या connection hints (dns-prefetch, preconnect, prerender, prefetch)। |
ऑटोमैटिक टेस्ट
test_failed का मतलब है कि automatic test में कम से कम एक limit टूटी। अलग-अलग कारण उसके नीचे दिए गए हैं, हर एक के साथ मापी गई वैल्यू और limit।
perf_no_ready
लोड होने के बाद widget ने overlay को कभी रिपोर्ट नहीं किया। आमतौर पर <script src="/sdk/v1.js"> गायब होता है या पेज कभी पूरा लोड नहीं होता।
perf_ready_slow
बहुत देर से तैयार हुआ: पेज लोड होने के 3000 ms से ज़्यादा बाद।
perf_unresponsive
Overlay की जाँच का जवाब नहीं देता, या बहुत धीरे देता है (कोड browser को block करता है)।
perf_navigated
Widget दूसरे पेज पर चला गया या उसने अपना पेज reload किया।
perf_flood
Widget overlay को बहुत ज़्यादा मैसेज भेजता है।
perf_idle_cpu
कुछ न होने पर भी 2 % से ज़्यादा CPU।
perf_storm_cpu
ढेर सारे events पर 15 % से ज़्यादा CPU।
perf_heap
64 MB से ज़्यादा memory।
perf_dom
पेज पर 3000 से ज़्यादा elements।
perf_long_task
Browser को एक बार में 200 ms से ज़्यादा block करता है।
network_attempt
किसी दूसरी साइट से कुछ लोड करने की कोशिश करता है (host दिखाया जाता है)।
runtime_errors
सिर्फ़ एक संकेत, फ़ेल होने का कारण नहीं: test के दौरान JavaScript errors। Admin को पहली error दिखती है।
| कोड | मतलब |
|---|---|
| perf_no_ready | लोड होने के बाद widget ने overlay को कभी रिपोर्ट नहीं किया। आमतौर पर <script src="/sdk/v1.js"> गायब होता है या पेज कभी पूरा लोड नहीं होता। |
| perf_ready_slow | बहुत देर से तैयार हुआ: पेज लोड होने के 3000 ms से ज़्यादा बाद। |
| perf_unresponsive | Overlay की जाँच का जवाब नहीं देता, या बहुत धीरे देता है (कोड browser को block करता है)। |
| perf_navigated | Widget दूसरे पेज पर चला गया या उसने अपना पेज reload किया। |
| perf_flood | Widget overlay को बहुत ज़्यादा मैसेज भेजता है। |
| perf_idle_cpu | कुछ न होने पर भी 2 % से ज़्यादा CPU। |
| perf_storm_cpu | ढेर सारे events पर 15 % से ज़्यादा CPU। |
| perf_heap | 64 MB से ज़्यादा memory। |
| perf_dom | पेज पर 3000 से ज़्यादा elements। |
| perf_long_task | Browser को एक बार में 200 ms से ज़्यादा block करता है। |
| network_attempt | किसी दूसरी साइट से कुछ लोड करने की कोशिश करता है (host दिखाया जाता है)। |
| runtime_errors | सिर्फ़ एक संकेत, फ़ेल होने का कारण नहीं: test के दौरान JavaScript errors। Admin को पहली error दिखती है। |
क्या यह लेख मददगार था?