Widget नियम: साइज़, परफ़ॉर्मेंस लिमिट और चेक कोड

साइज़, फ़ाइल टाइप, परफ़ॉर्मेंस लिमिट और हर वह कोड जिससे चेक फ़ेल हो सकता है।

8 मिनट में पढ़ें 4 नव॰ 2026 को अपडेट किया गया

widget overlay में बाकी सब चीज़ों के साथ चलता है, अक्सर धीमे PCs पर। इसलिए तय लिमिट लागू होती हैं। Livedeck यही नंबर तीन जगह इस्तेमाल करता है: यहाँ docs में, अप्रूवल से पहले के ऑटोमैटिक टेस्ट में और LIVE के दौरान overlay में।

पैकेज

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

LIVE के दौरान

  • overlay हर 2000 ms पर चेक करता है। लगातार 3 जवाब 1000 ms से धीमे हों, या 6000 ms तक कोई जवाब न आए, तो widget बंद हो जाता है।
  • अगर overlay खुद अटका हुआ था (जैसे tab background में होने की वजह से), तो इसे कभी आपके widget के ख़िलाफ़ नहीं गिना जाता।
  • जो widget बंद कर दिया गया था, वह अगले reload तक बंद ही रहेगा। इसके बाद editor में "Widget रुक गया" दिखेगा।
टिप: पेज हल्का रखें: पुराने elements हटाएँ (starter kit ज़्यादा से ज़्यादा maxCards कार्ड दिखाता है), JavaScript loops की जगह CSS animations इस्तेमाल करें और जब कुछ न हो रहा हो तब timers न चलाएँ।

जाँच कोड

जाँच फ़ेल होने पर 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)।

फ़ाइलें और कंटेंट

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 दिखती है।

क्या यह लेख मददगार था?