役立つサポートリンクは、一つの不具合を最少のコードと個人情報のないデータで再現します。実行手順、期待、実際、試験環境がすぐ分かる必要があります。本番ページ全体のコピーは原因を隠し、漏えいリスクを増やします。

再現するカウンター不具合をダウンロードする

カウンターfixtureをダウンロード。UTF-8で1486バイトです。増加ボタン、リセットボタン、見えるカウントがあり、外部リソース、アカウント状態、本番APIを使いません。

  • 手順: 増加を2回押す。
  • 期待: 表示カウントが2になる。
  • 意図的に壊したこのfixtureでの実際: カウントが0のまま。
  • 原因: count = count++ が元の値を count へ戻している。
  • 試す修正: その文を count += 1 へ置き換え、同じ手順を繰り返す。

提供のローカルDOM確認は、元のscriptと修正後のscriptの両方を実行します。Chrome、Safari、公開中のビューアーを試験したという主張ではありません。自分の再現を公開した後は、そこで失敗を再確認できたときだけ実際のbrowser、viewport、日付を記録します。

共有前に小さくする

  1. 新しいローカルHTMLへ失敗を移す。
  2. 失敗に無関係なframework、component、style、dataを削除。
  3. 氏名、email、ID、URL、token、顧客内容をfixtureへ置換。
  4. 本番APIを決定的なローカル応答へ置換。
  5. 不具合が残るか確認。
  6. 依存をもう一つ消して再確認。
  7. 期待と実際の結果、手順、browser、viewport、日付をデモの上に記載。

最小再現例の要点は、問題を示すのに足るコードだけを残し、原因に寄与しないものを除くことです。

ページ内に再現条件を書く

ファイル内に簡潔な説明欄を置きます。

Expected: 増加を2回押すと2が表示される。
Actual: 提供のfixtureではカウントが0のまま。
Steps: リセット → 増加 → 増加。
Browser / viewport / 日付: 共有したURLで試験した後に記入する。

consoleは必要な出力だけにします。analytics ID、session storage、request header、production logを入れません。

プレビューの境界

HTML2WEBは隔離viewerでinline HTML、CSS、scriptを許可し、任意の外部接続を止めます。そのためブラウザーで見える1ファイルの問題に向きます。認証API、cookie、service worker、cross-origin要求、SSR、メール配信、production DBの状態の再現には向きません。

backendを外すと不具合も消える場合は、サポートの承認済み安全経路でrepository fixtureかstaging環境を渡します。

公開して検証

  • secretと個人情報を検索。
  • 短い期限を選択。
  • HTMLを1ファイルだけ公開。
  • 公開リンクをprivate windowで開く。
  • 記載した手順をそのまま再実行。
  • 管理URLを非公開に保つ。
  • 公開URLと短い手順だけ課題へ添付。
  • 調査後に共有を削除。

期限と削除は以後のアクセスを減らしますが、保存済みコピーは回収できません。資格情報は公開せず、漏れた秘密値は交換します。

再現はHTML URL変換ツールで作れます。元のページにローカルCSSや画像があるなら、先にfile://素材が共有後に壊れる理由を読んでください。