Otomatik testlerde e-postadan OTP kodu, kararsızlık olmadan

Kod gerçekte nerede

Bir doğrulama e-postasının, kodun yaşayabileceği en fazla üç yeri vardır ve hangisini okumanız gerektiği sonrasındaki her şeyi belirler. API'den gelen mesaj JSON'u üçünü birden verir: subject, text (düz metin parçası, ya da null) ve html (HTML parçası, ya da null).

Tercih edilmesi gereken, düz metin parçasıdır ve çoğu şablonlama sisteminin HTML'den otomatik olarak ürettiği de odur — bu yüzden genellikle oradadır. null olduğunda, HTML parçası tek gövdedir ve sonraki iki bölüm onu güvenli şekilde okumakla ilgilidir.

Deseni kendi ifadenize sabitleyin

İçgüdüsel olan \d{6}'dır. Kodla eşleşir, ama aynı zamanda alt bilgideki yılla, adres bloğundaki posta koduyla, bir telefon numarasının son altı rakamıyla ve kodun iki satır üstünde görünen sipariş numarasıyla da eşleşir. Hangisi önce gelirse o kazanır ve test onu tam bir güvenle forma yazar.

\D{0,12}, pratik ayrıntıdır: etiketler boşluklarla değiştirildikten sonra, kelimeler ve rakamlar bir iki nokta üst üste, bir dizi boşluk ya da aralarında bulunan bir <strong>'ten kalan döküntüyle ayrılmış olabilir. En fazla bir düzine rakam-olmayan karakter, desenin başka bir sayıya atlamasına izin vermeden bunların hepsini kapsar.

Rakamları bölen şablonlar

Yaygın bir tasarım, kodun her rakamını kendi kutusuna koyar, böylece telefonda iyi okunur. HTML'de bu, altı tablo hücresi ya da altı <span>'dir ve sayı, kaynağın hiçbir yerinde art arda altı karakter olarak görünmez:

<p>Your code is</p>
<table><tr>
  <td class="digit">4</td><td class="digit">8</td><td class="digit">1</td>
  <td class="digit">9</td><td class="digit">2</td><td class="digit">0</td>
</tr></table>

Ham HTML üzerindeki bir regex hiçbir şey bulamaz. Çözüm daha akıllı bir regex değildir; önce HTML'i sabit bir sırayla metne dönüştürmektir:

1. Her etiketi bir boşlukla değiştirin. Hiçbir şeyle değil, bir boşlukla — <td>4</td><td>8</td>, ardından gelene yapışık 48 değil, 4 8 haline gelmelidir.
2. Varlıkları çözün. &,  , '. İki rakam arasındaki bir bölünemez boşluk, çözülene kadar bir regex için boşluk değildir.
3. Boşlukları katlayın, ardından rakamların aralarında boşluk olmasına izin vererek eşleştirin. Kutulu tasarım için code is\D{0,12}(\d)\s*(\d)\s*(\d)\s*(\d)\s*(\d)\s*(\d) kullanıp grupları birleştirin; normal bir şablon için önceki bölümdeki yalın desen yeterlidir.

Aşağıdaki yardımcılar, birinci ve ikinci adımları sizin için yapar ve her iki parçayı aynı anda arar, böylece bir testin şablonun bu ay hangi tasarımı kullandığını bilmesi gerekmez.

En yeni mesaj her zaman doğru olan değildir

Buradaki her posta kutusu listelemesi en yeniden başlayarak döner ve çoğu ilk taslak messages[0]'ı okur. Üç durum bunu yanlış mesaj haline getirir:

Tek bir eylemden iki mesaj

Kayıt, göndereninin kuyruğunun boşaldığı sırayla bir hoş geldin postası ve bir kod postası gönderir. Yarı yarıya, hoş geldin mesajı en yenisidir. Herhangi bir şey almadan önce konu ya da gönderen üzerinde filtreleyin.

Bir yeniden gönderim

Test kodu iki kez istedi — biri yanlışlıkla, biri bilerek — ve sunucu yalnızca en sonuncuyu kabul ediyor. Eski mesaj hâlâ posta kutusundadır, hâlâ desenle eşleşir ve hâlâ artık geçersiz olan altı rakama ayrıştırılır.

Önceki bir test çalıştırması

Yalnızca adres yeniden kullanıldıysa, ki bu asla olmamalıdır. Çalıştırma başına yeni bir adres bu durumu imkansız kılar; birine sahip olamıyorsanız, aşağıdaki anlık görüntü geri dönüş çözümüdür.

Sağlam yaklaşım her test çalıştırıcısında aynıdır: postayı tetiklemeden önce posta kutusunda ne olduğuna bakın, ardından yalnızca henüz orada olmayan ve beklediğiniz konuyla eşleşen bir mesajı kabul edin.

// Remember what is already there, THEN trigger the resend, THEN wait for something new.
const before = new Set((await listMailbox(address)).messages.map(m => m.id));

await page.getByRole('button', { name: 'Resend code' }).click();

const fresh = await waitFor(address, m => !before.has(m.id) && /code/i.test(m.subject));

Çalıştırma sırasında süresi dolan kodlar

Çoğu tek seferlik kod, beş ila on beş dakika geçerlidir. Bu, bir test paketi yirmi spec'i sıraya alana kadar cömert gelir; her biri kodunu başta ister ve sonda yazar. Üç kural kodu canlı tutar:

• Kodu olabildiğince geç isteyin. Gönderimi, diğer testler sırada beklerken çalışan bir kurulum adımında değil, beklemeden hemen önce tetikleyin.
• Bekleme son tarihini kodun ömrünün oldukça altında tutun. On dakikalık bir kod için altmış saniyelik bir son tarih, onu yazmak için dokuz dakika bırakır. On dakikalık bir son tarih ise hiçbir şey bırakmaz.
• Bir kodu asla başka bir test için saklamayın. Kodlar hem kısa ömürlüdür hem de tek kullanımlıktır; birini dağıtan paylaşılan bir fixture, tek bir sayı için iki test arasında bir yarıştır.

Doğrudan kullanılabilir extractor'lar

Aynı dört satırın üç sürümü: her iki parça birleştirilir, etiketler boşluğa çevrilir, varlıklar çözülür, boşluklar katlanır, ardından sabitlenmiş desen uygulanır. Deseni şablonunuzun ifadesiyle eşleşecek şekilde değiştirin, başka hiçbir şeye dokunmanız gerekmez.

Bir kabuktan, jq ile

curl -sG "https://grabmail.io/api/v1/message/$ID" --data-urlencode "mailbox=$ADDR" \
| jq -r '[.text, .html] | map(select(. != null)) | join(" ") | gsub("<[^>]*>"; " ")' \
| grep -oiE 'code is[^0-9]{0,12}[0-9]{6}' | grep -oE '[0-9]{6}' | head -1

Python

import html
import re

TAGS = re.compile(r"<[^>]+>")
CODE = re.compile(r"code is\D{0,12}(\d{6})", re.I)      # anchored on YOUR template's wording


def text_of(message: dict) -> str:
    """Both parts as plain text: tags out, entities decoded, whitespace folded."""
    raw = f"{message.get('text') or ''}\n{message.get('html') or ''}"
    return re.sub(r"\s+", " ", html.unescape(TAGS.sub(" ", raw)))


def code_from(message: dict, pattern: re.Pattern = CODE) -> str:
    hit = pattern.search(text_of(message))
    if not hit:
        raise AssertionError(f"no code in message {message['id']!r} ({message['subject']!r})")
    return hit.group(1)

TypeScript

export type Message = { id: string; subject: string; text: string | null; html: string | null };

const TAGS = /<[^>]+>/g;
const ENTITIES: Record<string, string> = { '&amp;': '&', '&lt;': '<', '&gt;': '>', '&quot;': '"', '&#39;': "'", '&nbsp;': ' ' };

/** Both parts as plain text: tags out, the common entities decoded, whitespace folded. */
export const textOf = (m: Message): string =>
  `${m.text ?? ''}\n${m.html ?? ''}`
    .replace(TAGS, ' ')
    .replace(/&(amp|lt|gt|quot|#39|nbsp);/g, e => ENTITIES[e])
    .replace(/\s+/g, ' ');

/** Anchored on your own wording. A reworded template fails loudly. */
export function codeFrom(m: Message, pattern = /code is\D{0,12}(\d{6})/i): string {
  const hit = textOf(m).match(pattern);
  if (!hit) throw new Error(`no code in message ${m.id} ("${m.subject}")`);
  return hit[1];
}

Bunların okuduğu mesaj JSON'u, API referansında belgelenen GET /api/v1/message/{id} ile alınır; kimliği baştan elde etmenizi sağlayan bekleme uçtan uca test rehberinde anlatılıyor, ayrıca Playwright, Cypress, Python ve Node.js için hazır yardımcılar olarak da mevcut.

Bitti demeden önce

• Şablonunuzun ifadesine sabitlenmiş ve şablonun yanında tutulan desen.
• Metin olarak aranan her iki parça: etiketler boşluğa çevrilir, varlıklar çözülür, boşluklar katlanır.
• Konu ya da gönderen üzerinde bir filtre, böylece bir hoş geldin postası bir kod postasına asla üstün gelmez.
• Herhangi bir yeniden gönderimden önce bir anlık görüntü ve ondan sonra yalnızca yeni mesajların kabul edilmesi.
• Kodun ömrünün oldukça altında bir bekleme son tarihi ve beklemeden hemen önce tetiklenen gönderim.
• Baktığı mesaj kimliğini ve konuyu belirten bir başarısızlık mesajı.

Bu, altı haneli bir extractor'ın yanlış sayı üzerinden geçtiği görülmüş her yolu kapsar. Aynı postayı okuyan bir ajan, aynı sorunlara sahiptir ve bunlar için bir araç eksiktir; MCP sunucusunun ona bir tahmin yerine mesajın tamamını vermesinin nedeni de budur — bir yapay zekâ ajanının okuyabileceği bir gelen kutusu bunu ele alır.

Sorular