リモート Mac で iOS の単体テストを実行しても、フォームが末尾の改行や全角数字を受け付けたり、極端に長い入力でスレッドが処理にかかりきりになったりすることがあります。原因はたいていマシンではなく、バリデーションの契約にあります。確認しているのは「条件に合う部分が見つかること」でしょうか。それとも「フィールド全体が条件に合うこと」でしょうか。ここでは、固定形式の業務用番号を使って再現可能な受け入れテストを整え、まず正しさを確認してから、バックトラックのリスクを検証します。
まずフィールドの書式を契約として定義する
番号は ASCII の英大文字二文字、ハイフン一文字、ASCII の数字六文字のみで構成されるものとします。例は AB-123456 です。全体の長さは UTF-16 コードユニットで九個とし、空白、改行、暗黙の書式変換は認めません。
まずプロジェクトのテストターゲットに受け入れる例と拒否する例を用意し、その後でバリデーターを実装します。本番環境のユーザー入力をそのままサンプルに使わないでください。固定のテストフィクスチャなら再現しやすく、テストの生成物に個人情報が残ることもありません。
業務ルールとして前後の空白除去を認める場合は、前処理を独立したステップにし、元の入力と前処理後の結果をそれぞれテストします。検証関数が黙って内容を書き換える設計は避けてください。クライアント、サーバー、監査ログで、異なる番号が扱われるおそれがあります。
本当の完全一致を実装する
Foundation の正規表現が扱う範囲は UTF-16 ベースなので、Swift の String.count から直接 NSRange を作ることはできません。次の実装は XCTest のテストファイルに配置できます。まず動作を確認し、その後で業務ロジックのモジュールへ移してください。
import Foundation
import XCTest
private enum TicketCode {
static let pattern = #"\A[A-Z]{2}-[0-9]{6}\z"#
static let regex = try! NSRegularExpression(pattern: pattern)
static func accepts(_ input: String) -> Bool {
guard input.utf16.count == 9 else { return false }
let full = NSRange(input.startIndex..<input.endIndex, in: input)
guard let match = regex.firstMatch(
in: input,
options: [],
range: full
) else {
return false
}
return NSEqualRanges(match.range, full)
}
}
final class TicketCodeTests: XCTestCase {
func testValidationBoundaries() {
let cases: [(String, Bool)] = [
("AB-123456", true),
("ab-123456", false),
("AB-12345", false),
("AB-1234567", false),
("AB-123456\n", false),
(" AB-123456", false),
("AB-123456", false),
("AB-١٢٣٤٥٦", false),
("AB–123456", false),
("🙂AB-123456", false)
]
for (input, expected) in cases {
XCTAssertEqual(
TicketCode.accepts(input),
expected,
"Unexpected result for \(input.debugDescription)"
)
}
}
}
ここでの try! は、コード内に固定で記述し、テスト済みのパターンに限って使用しています。パターンをファイルや設定から読み込む場合は、エラーをスローする初期化処理を使い、設定の不備を報告する必要があります。正規表現は一度だけコンパイルし、入力のたびにオブジェクトを作り直さないようにします。
\A と \z は、それぞれ文字列全体の先頭と末尾を明示的に指定します。後でパターンを変更する場合も、入力全体の範囲との比較は残してください。検証処理が単なる部分文字列の検索に変わってしまうのを防げます。
Unicode と長さの境界を網羅する
ASCII 数字だけを受け付けるフィールドでは [0-9] を使い、\d を同じ意味の表記として扱わないでください。Unicode 対応の正規表現では、数字のカテゴリに他の文字体系の数字が含まれることがあります。見た目が似たダッシュも ASCII のハイフンとは別の文字なので、明確に拒否する必要があります。
長さのルールでは、単位も明記します。String.count は拡張書記素クラスタを数え、UTF-16 の長さは Foundation の範囲指定に使い、UTF-8 のバイト数は転送量の制限に適しています。この三つの値は相互に置き換えられません。特に自由記述の備考欄に、九個のコードユニットというルールをそのまま適用してはいけません。
テストには、空文字列、結合文字、CRLF、長さの上限の直前と直後に当たる入力も追加します。製品として Unicode 正規化が必要な場合は、まず正規化形式を確定し、正規化前後の入力が受け入れられるかをテストしてください。「見た目が同じだから」という理由で番号の書式を緩めるべきではありません。
バリデーターは、契約に合わない元の入力を拒否するべきです。入力を許容するための変換は別の層の責務であり、独立したルールとテストが必要です。
バックトラックの実験を通常のテストから分離する
通常の XCTest プロセス内で、入力を際限なく長くして危険なパターンを試さないでください。(a+)+ のような入れ子の繰り返しは、長い文字列の末尾に一致しない文字があると、膨大な数の候補経路を探索する可能性があります。短いサンプルが一度すぐに処理できたとしても、そのパターンが安全だという証明にはなりません。
コードレビューでは、まず入れ子の量指定子、重複する選択肢、不要なワイルドカードを確認します。フィールドの書式を固定長にできる場合は、明確な文字クラスと繰り返し回数を優先してください。複雑な入れ子構造を持つ形式には専用パーサーを検討し、正規表現をさらに積み重ねるのは避けます。
残さざるを得ない複雑なパターンについては、長さを段階的に増やした固定サンプルを、独立したコマンドラインプロセスで実行します。親プロセスが実行全体の制限時間を管理し、タイムアウト時には子プロセスを終了させ、その終了を待ちます。長さごとに別のプロセスを起動し、パターンのバージョン、入力の長さ、終了ステータス、所要時間を記録してください。機密性のある入力本文は記録しません。
処理をバックグラウンドキューに投げ、結果を待つのをやめても、実行中のマッチングが自動的にキャンセルされるわけではありません。NSRegularExpression の一般的なマッチング API には、処理を強制終了する時間制限を直接設定する機能がありません。スレッドを分けることと、リソースを隔離することも別です。
リモート Mac で受け入れ検証の記録を残す
VPSPull のクラウド Mac では、まず sw_vers と xcodebuild -version の出力を記録し、その後で上記のテストを含むテストターゲットを実行します。コミット識別子、パターンの文字列、テスト結果を保存しておけば、コードの変更とシステム側の正規表現実装の変更を切り分けやすくなります。
性能測定は、固定したビルド構成で別途実行し、測定中に並列でビルドを走らせないようにします。しきい値は同じ環境で繰り返し測定した結果から決め、一度の実経過時間を汎用的な指標として扱わないでください。システムをアップグレードした後は、まずベースラインを取り直してから、性能の退行を判断します。
最後に三点を確認します。正しい入力が全体として受け入れられること、不正な入力が明確な境界で拒否されること、リスク検証の実験がメインのテストプロセスを止めないことです。文字列の長さを求める処理自体にも入力の走査が必要なので、入力の受け付け時点でリクエストやファイルのサイズも制限してください。これらをマージ時の受け入れ条件に組み込めば、正規表現の変更を数件の手作業のサンプルだけで承認せずに済みます。
よくある質問
firstMatch の結果範囲を確認するのはなぜですか?
firstMatch は不正な入力の中から有効な部分だけを見つける場合があります。フィールド全体を検証するには、結果範囲が入力全体の範囲と一致することを要求し、開始と終了の境界も明示します。
非同期のタイムアウトで正規表現の実行を停止できますか?
できません。待機を終了しても、実行中の NSRegularExpression の照合は中断されません。入力長を制限してパターンを単純化し、疑わしいパターンは終了可能な別プロセスで調べてください。
専用 Mac でワークフローを検証
モデル、ノード、利用期間を確認してから、まずは1日単位でお試しください。実際の利用可否はコントロールパネルに表示される最新状況をご確認ください。