กฎของวิดเจ็ต: ขนาด ขีดจำกัดประสิทธิภาพ และรหัสการตรวจสอบ
ขนาด ประเภทไฟล์ ขีดจำกัดประสิทธิภาพ และรหัสทั้งหมดที่ทำให้การตรวจสอบไม่ผ่าน
วิดเจ็ตทำงานใน overlay ร่วมกับทุกอย่าง ซึ่งมักเป็นพีซีที่ช้ากว่า จึงมีขีดจำกัดตายตัว Livedeck ใช้ตัวเลขชุดเดียวกันในสามที่: ในเอกสารนี้ ในการทดสอบอัตโนมัติก่อนอนุมัติ และใน overlay ระหว่าง LIVE
แพ็กเกจ
ไฟล์ ZIP
5 MB
รวมหลังแตกไฟล์
5 MB
ไฟล์เดี่ยว
2 MB
ไฟล์
200
ความยาวพาธ
180 ตัวอักษร
ความลึกของโฟลเดอร์
8
manifest.json
64 KB
| ขีดจำกัด | ค่า |
|---|---|
| ไฟล์ 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
| การวัด | ขีดจำกัด |
|---|---|
| พร้อมใช้งานหลังหน้าโหลดเสร็จ | 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 หยุดทำงาน"
รหัสผลการตรวจสอบ
เมื่อการตรวจสอบไม่ผ่าน เอดิเตอร์หรือ 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)
| รหัส | ความหมาย |
|---|---|
| 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)
| รหัส | ความหมาย |
|---|---|
| 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 ระหว่างการทดสอบ แอดมินจะเห็นข้อผิดพลาดแรก
| รหัส | ความหมาย |
|---|---|
| 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 ระหว่างการทดสอบ แอดมินจะเห็นข้อผิดพลาดแรก |
บทความนี้มีประโยชน์ไหม?