リモート Mac：
Cypress WebKit と Safari の受入チェックリスト
回帰担当者向けです。Cypress の実験的 WebKit は Safari と同一ではありません。表とキャッシュ、動画・スクショ、並列・リトライ、出荷前三歩を一枚にしました。Vitest と Safari 対照、Playwright 互換併読を推奨します。
01 三つの痛み
いち、CI の緑を Safari 保証と誤読。に、録画常時オンでディスク枯渇。さん、並列とリトライ過多でフレーク隠蔽。
02 Cypress と WebKit の適用シーン（エクスペリメンタル）
WebKit は Chromium より Safari に近いが版は一致しません。広い回帰に使い、課金・ストレージ・自動再生は実 Safari で別ラベル検証が必須です。デプロイ後 Safari 三歩も参照ください。
03 実 Safari との差異対照表
| 観点 | Cypress WebKit | 実 Safari |
|---|---|---|
| 版とポリシー | Cypress 同梱 WebKit | OS バンドル Safari |
| メディア・ITP | 設定差で分岐しうる | ユーザー環境が正 |
| GPU・描画 | ヘッドレス差が出やすい | 手動見え方が最終 |
04 リモート Mac 上のブラウザ二進キャッシュとインストール引数
混在ホストでは CYPRESS_CACHE_FOLDER を永続ボリュームへ。cypress install 後ログに WebKit 取得パスを残す。既定例 ~/Library/Caches/Cypress。実行は --browser webkit。クリーンジョブはキャッシュキーに Cypress 版を含め、エージェント間の取り違えを防ぎます。
05 video／screenshot スイッチ
本番相当枝は video オフ、screenshotOnRunFailure のみ。調査枝のみ録画オン、成果物は失敗時に限定。長尺は解像度を README に明記。
06 並列 worker とリトライ閾値
並列はコアと入出力から逆算し同時ブラウザ数に上限。分割実行はディスク競合で遅くなる場合あり。retries は runMode で一二回まで、超過はバグ扱い。数値は CONTRIBUTING に固定。
07 リリース前三歩の受入
- Node・Cypress・キャッシュを記録しクリーンで再現。
- 動画・並列・リトライを設定とログで一致。
- 同一 Mac の Safari で P0 を突合し承認。
受入チェックリスト（抜粋）
- automation と safari_manual ラベル併記
- 失敗時のみ動画・トレースを artifacts へ
- リトライ超過は未マージでチケット化
引用メモ キャッシュキーに版 並列はコア六割から リトライ二回までを初期推奨