กฎของวิดเจ็ต: ขนาด ขีดจำกัดประสิทธิภาพ และรหัสการตรวจสอบ

ขนาด ประเภทไฟล์ ขีดจำกัดประสิทธิภาพ และรหัสทั้งหมดที่ทำให้การตรวจสอบไม่ผ่าน

อ่าน 8 นาที อัปเดตเมื่อ 4 พ.ย. 2569

วิดเจ็ตทำงานใน overlay ร่วมกับทุกอย่าง ซึ่งมักเป็นพีซีที่ช้ากว่า จึงมีขีดจำกัดตายตัว Livedeck ใช้ตัวเลขชุดเดียวกันในสามที่: ในเอกสารนี้ ในการทดสอบอัตโนมัติก่อนอนุมัติ และใน overlay ระหว่าง LIVE

แพ็กเกจ

ไฟล์ ZIP

5 MB

รวมหลังแตกไฟล์

5 MB

ไฟล์เดี่ยว

2 MB

ไฟล์

200

ความยาวพาธ

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 รูปภาพ เสียง และฟอนต์ต้องเป็นไฟล์ตามนามสกุลจริง

สิ่งที่ไม่อนุญาต

  • ที่อยู่ของเว็บอื่นใน HTML, CSS, JavaScript, SVG หรือ JSON (http://, https://, ws://, wss:// หรือ //host) ที่อยู่ในคอมเมนต์ไม่ทำให้ตรวจสอบไม่ผ่าน แต่แอดมินจะเห็น
  • iframe, frame, object, embed, portal, base และ meta refresh ใน HTML
  • WebRTC (RTCPeerConnection, เซิร์ฟเวอร์ STUN หรือ TURN), เฟรมจาก JavaScript (createElement("iframe") หรือ "<iframe" ในสตริง) และคำแนะนำการเชื่อมต่อ เช่น dns-prefetch หรือ preconnect นอกจากนี้ Livedeck ยังปิดฟีเจอร์เหล่านี้ภายในวิดเจ็ตด้วย
  • สคริปต์, event handler หรือ foreignObject ในไฟล์ SVG
  • ไฟล์ ZIP ที่เข้ารหัส, symbolic link และไฟล์บีบอัดซ้อนในไฟล์บีบอัด

แอดมินยังเห็นคำเตือนเกี่ยวกับ eval, new Function, WebAssembly, WebSockets, การเข้าถึงพื้นที่จัดเก็บหรือหน้าต่าง overlay, รูปแบบการขุดเหรียญ และโค้ดที่ถูกทำให้อ่านยากหรือ minify คำเตือนไม่ทำให้ตรวจสอบไม่ผ่านทันที แต่ต้องมีเหตุผลที่ดี หากส่งโค้ดที่ minify ให้แนบซอร์สที่อ่านได้ไว้ในโฟลเดอร์ src/ ด้วย

manifest.json, โฟลเดอร์ src/ และไฟล์ .md หรือ .txt ใช้สำหรับการรีวิวเท่านั้น Livedeck จะไม่ส่งไฟล์เหล่านี้ให้ overlay โค้ดของคุณจึงโหลดไม่ได้ ผู้ใช้แต่ละคนจะได้รับวิดเจ็ตของคุณผ่านที่อยู่เฉพาะของตัวเอง

ขีดจำกัดประสิทธิภาพ

พร้อมใช้งานหลังหน้าโหลดเสร็จ

3000 ms

การโหลดหน้าระหว่าง LIVE

15,000 ms

CPU เมื่อไม่มีอีเวนต์ (เฉลี่ย)

2 %

CPU เมื่อมีอีเวนต์จำนวนมาก (เฉลี่ย)

15 %

หน่วยความจำ (JavaScript)

64 MB

องค์ประกอบบนหน้า

3000

การค้างนานที่สุดต่อครั้ง

200 ms

ระหว่าง LIVE

  • overlay ตรวจสอบทุก 2000 ms หากตอบช้ากว่า 1000 ms ติดกัน 3 ครั้ง หรือไม่ตอบเลยนาน 6000 ms วิดเจ็ตจะถูกปิด
  • หาก overlay ค้างเอง (เช่น เพราะแท็บอยู่เบื้องหลัง) จะไม่นับเป็นความผิดของวิดเจ็ตคุณ
  • Widget ที่ถูกปิดไปจะยังคงปิดอยู่จนกว่าจะโหลดหน้าใหม่ จากนั้นเอดิเตอร์จะแสดง "Widget หยุดทำงาน"
เคล็ดลับ: ทำให้หน้าเบาไว้: ลบองค์ประกอบเก่าออก (starter kit แสดงการ์ดได้สูงสุด maxCards ใบ) ใช้ CSS animation แทนการวนลูปด้วย JavaScript และอย่าเปิดตัวจับเวลาไว้ขณะที่ไม่มีอะไรเกิดขึ้น

รหัสผลการตรวจสอบ

เมื่อการตรวจสอบไม่ผ่าน เอดิเตอร์หรือ seller studio จะแสดงรายการสาเหตุ รหัสทั้งหมดแสดงไว้ที่นี่

ไฟล์ ZIP

zip_too_large

ไฟล์ ZIP ใหญ่เกิน 5 MB

zip_total_too_large

ใหญ่เกิน 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

ไม่รองรับวิธีบีบอัดนี้ ใช้ได้เฉพาะ Stored (ไม่บีบอัด) และ Deflate (ค่าเริ่มต้น)

zip_header_mismatch

ข้อมูลในไฟล์บีบอัดขัดแย้งกันเอง

zip_overlap

มีไฟล์ซ้อนทับกันภายในไฟล์บีบอัด

zip_crc_mismatch

Checksum ไม่ถูกต้อง มีไฟล์เสียหาย

zip_symlink

มี symbolic link อยู่ในแพ็กเกจ

zip_bad_name

ชื่อไฟล์ไม่ถูกต้อง: มีอักขระที่ไม่ใช่ ASCII โดยไม่ใช้ UTF-8, มี ../, เป็น path แบบสัมบูรณ์, มีอักขระพิเศษ, ยาวเกิน 180 ตัวอักษร หรือซ้อนลึกเกิน 8 โฟลเดอร์

zip_duplicate_name

มีไฟล์ซ้ำกันสองครั้งในไฟล์บีบอัด

zip_nested_archive

มีไฟล์บีบอัดซ้อนอยู่ข้างใน (เช่น ZIP ใน ZIP)

ไฟล์และเนื้อหา

manifest_missing

ไม่พบ manifest.json ต้องอยู่ชั้นบนสุดของ ZIP หรืออยู่ในโฟลเดอร์เดียวที่มีอยู่

manifest_invalid

manifest.json ไม่ถูกต้อง ข้อผิดพลาดแสดงอยู่ด้านล่าง (ดูรหัสใน "ข้อมูลอ้างอิง manifest.json")

entry_missing

ไม่พบไฟล์เริ่มต้นที่ระบุใน entry ในแพ็กเกจ

file_type_not_allowed

ไม่อนุญาตไฟล์ประเภทนี้

file_content_mismatch

เนื้อหาไม่ตรงกับนามสกุลไฟล์ (เช่น ไฟล์ JPG ที่ตั้งชื่อเป็น .png)

file_not_utf8

ไฟล์ข้อความไม่ได้บันทึกเป็น UTF-8

file_empty

ไฟล์ว่างเปล่า

external_reference

ไฟล์มีที่อยู่ของเว็บไซต์อื่น (พร้อมระบุบรรทัด)

forbidden_markup

มี HTML ที่ไม่อนุญาต (iframe, frame, object, embed, portal, base, meta refresh) หรือมีสคริปต์ในไฟล์ SVG

forbidden_api

มีโค้ดที่พยายามหลบการบล็อกเครือข่าย: WebRTC (RTCPeerConnection, STUN/TURN), การสร้าง frame ด้วย JavaScript (createElement("iframe"), "<iframe" ในสตริง) หรือ connection hint (dns-prefetch, preconnect, prerender, prefetch)

ทดสอบอัตโนมัติ

test_failed หมายความว่าการทดสอบอัตโนมัติเกินขีดจำกัดอย่างน้อยหนึ่งข้อ สาเหตุแต่ละข้อแสดงอยู่ด้านล่าง พร้อมค่าที่วัดได้และค่าขีดจำกัด

perf_no_ready

Widget ไม่ส่งสัญญาณถึงโอเวอร์เลย์เลยหลังโหลดเสร็จ ส่วนใหญ่เกิดจากไม่มี <script src="/sdk/v1.js"> หรือหน้าโหลดไม่เสร็จ

perf_ready_slow

พร้อมใช้งานช้าเกินไป: เกิน 3000 ms หลังหน้าโหลดเสร็จ

perf_unresponsive

ไม่ตอบการตรวจสอบของโอเวอร์เลย์ หรือตอบช้าเกินไป (โค้ดบล็อกเบราว์เซอร์)

perf_navigated

Widget เปลี่ยนไปหน้าอื่นหรือโหลดหน้าตัวเองใหม่

perf_flood

Widget ส่งข้อความถึงโอเวอร์เลย์มากเกินไปมาก

perf_idle_cpu

ใช้ CPU เกิน 2 % ขณะไม่มีอะไรเกิดขึ้น

perf_storm_cpu

ใช้ CPU เกิน 15 % เมื่อมีอีเวนต์จำนวนมาก

perf_heap

ใช้หน่วยความจำเกิน 64 MB

perf_dom

มีองค์ประกอบบนหน้าเกิน 3000 รายการ

perf_long_task

บล็อกเบราว์เซอร์นานกว่า 200 ms ต่อครั้ง

network_attempt

พยายามโหลดบางอย่างจากเว็บไซต์อื่น (แสดงชื่อโฮสต์)

runtime_errors

เป็นเพียงคำแนะนำ ไม่ใช่สาเหตุที่ทำให้ไม่ผ่าน: มีข้อผิดพลาด JavaScript ระหว่างการทดสอบ แอดมินจะเห็นข้อผิดพลาดแรก

บทความนี้มีประโยชน์ไหม?