ウィジェットのルール:サイズ、パフォーマンス制限、チェックコード

サイズ、ファイル形式、パフォーマンス制限、チェックで失敗するすべてのコード。

8分で読めます 2026年11月4日更新

ウィジェットはオーバーレイ内でほかの要素と一緒に動作し、性能の低い PC で使われることも多くあります。そのため固定の制限があります。Livedeck は同じ数値を 3 か所で使います:このドキュメント、承認前の自動テスト、そして 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)。コメント内のアドレスはチェックで不合格にはなりませんが、管理者には表示されます。
  • HTML 内の iframe、frame、object、embed、portal、base、meta refresh
  • WebRTC(RTCPeerConnection、STUN/TURN サーバー)、JavaScript からのフレーム(createElement("iframe") や文字列内の "<iframe")、dns-prefetch や preconnect などの接続ヒント。Livedeck はウィジェット内でもこれらの機能を無効にします。
  • SVG ファイル内のスクリプト、イベントハンドラー、foreignObject
  • 暗号化された ZIP ファイル、シンボリックリンク、アーカイブ内のアーカイブ

管理者には、eval、new Function、WebAssembly、WebSocket、ストレージやオーバーレイウィンドウへのアクセス、マイニングのパターン、難読化または minify されたコードに関するヒントも表示されます。ヒントがあってもすぐに不合格にはなりませんが、正当な理由が必要です。minify したコードは、読みやすいソースを src/ フォルダに入れて一緒に提出してください。

manifest.json、src/ フォルダ、.md や .txt ファイルは審査専用です。Livedeck はこれらをオーバーレイに配信しないため、コードから読み込むことはできません。ウィジェットはユーザーごとに専用のアドレスで提供されます。

パフォーマンス制限

ページ読み込み後の準備完了

3000 ms

LIVE 中のページ読み込み

15,000 ms

イベントなしの CPU(平均)

2 %

イベントが非常に多いときの CPU(平均)

15 %

メモリ(JavaScript)

64 MB

ページ上の要素数

3000

1 回あたりの最長ブロック

200 ms

LIVE 中

  • オーバーレイは 2000 ms ごとに確認します。1000 ms より遅い応答が 3 回続くか、6000 ms まったく応答がないと、ウィジェットはオフになります。
  • オーバーレイ自体が止まっていた場合(例:タブがバックグラウンドにあった場合)は、ウィジェットの責任としてカウントされません。
  • 停止されたウィジェットは、次に再読み込みするまで停止したままです。エディターには「ウィジェット停止中」と表示されます。
ヒント:ページは軽く保ってください。古い要素は削除し(スターターキットでは最大 maxCards 枚のカードを表示)、JavaScript のループではなく CSS アニメーションを使い、何も起きていない間はタイマーを動かさないでください。

チェックコード

チェックに失敗すると、エディターまたはセラースタジオに理由の一覧が表示されます。ここではすべてのコードを掲載しています。

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

複数に分割されています。すべてを 1 つのファイルにまとめてください。

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

チェックサムが一致しません。ファイルが破損しています。

zip_symlink

パッケージにシンボリックリンクが含まれています。

zip_bad_name

無効なファイル名です:UTF-8 指定のない非 ASCII 文字、../、絶対パス、特殊文字、180 文字超、または 8 階層を超えるフォルダー。

zip_duplicate_name

アーカイブ内に同じファイルが 2 回含まれています。

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

内容が拡張子と一致しません(例:.png という名前の JPG)。

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)、JavaScript からのフレーム(createElement("iframe")、文字列内の "<iframe")、接続ヒント(dns-prefetch、preconnect、prerender、prefetch)。

自動テスト

test_failed は、自動テストで 1 つ以上の制限を超えたことを意味します。個別の理由がその下に、測定値と制限値とともに表示されます。

perf_no_ready

ウィジェットが読み込み後にオーバーレイへ応答しませんでした。多くの場合、<script src="/sdk/v1.js"> がないか、ページの読み込みが完了していません。

perf_ready_slow

準備完了が遅すぎます:ページ読み込みから 3000 ms を超えています。

perf_unresponsive

オーバーレイのチェックに応答しないか、応答が遅すぎます(コードがブラウザーをブロックしています)。

perf_navigated

ウィジェットが別のページに移動したか、ページを再読み込みしました。

perf_flood

ウィジェットがオーバーレイに送るメッセージが多すぎます。

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 エラーです。管理者には最初の 1 件が表示されます。

この記事は役に立ちましたか?