ウィジェットのルール:サイズ、パフォーマンス制限、チェックコード
サイズ、ファイル形式、パフォーマンス制限、チェックで失敗するすべてのコード。
ウィジェットはオーバーレイ内でほかの要素と一緒に動作し、性能の低い PC で使われることも多くあります。そのため固定の制限があります。Livedeck は同じ数値を 3 か所で使います:このドキュメント、承認前の自動テスト、そして 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)。コメント内のアドレスはチェックで不合格にはなりませんが、管理者には表示されます。
- 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
| 測定項目 | 上限 |
|---|---|
| ページ読み込み後の準備完了 | 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 まったく応答がないと、ウィジェットはオフになります。
- オーバーレイ自体が止まっていた場合(例:タブがバックグラウンドにあった場合)は、ウィジェットの責任としてカウントされません。
- 停止されたウィジェットは、次に再読み込みするまで停止したままです。エディターには「ウィジェット停止中」と表示されます。
チェックコード
チェックに失敗すると、エディターまたはセラースタジオに理由の一覧が表示されます。ここではすべてのコードを掲載しています。
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)。
| コード | 意味 |
|---|---|
| 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)。
| コード | 意味 |
|---|---|
| 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 件が表示されます。
| コード | 意味 |
|---|---|
| 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 件が表示されます。 |
この記事は役に立ちましたか?