Mã OTP từ email trong test tự động, không còn test chập chờn

Mã thực sự nằm ở đâu

Một email xác minh có tối đa ba chỗ mà mã có thể nằm ở đó, và việc bạn nên đọc chỗ nào sẽ quyết định mọi thứ diễn ra sau đó. JSON của thư mà API trả về cho bạn cả ba cùng lúc: subject, text (phần văn bản thuần, hoặc null) và html (phần HTML, hoặc null).

Phần văn bản thuần là phần nên ưu tiên, và đây cũng là phần mà hầu hết các hệ thống template tự động sinh ra từ HTML — nên nó thường luôn có mặt. Khi nó là null, phần HTML sẽ là nội dung duy nhất, và hai phần tiếp theo nói về cách đọc nó một cách an toàn.

Neo mẫu biểu thức vào đúng câu chữ của riêng bạn

Bản năng đầu tiên là dùng \d{6}. Nó khớp với mã, nhưng cũng khớp với năm ở phần footer, mã bưu điện trong khối địa chỉ, sáu chữ số cuối của một số điện thoại, và mã đơn hàng xuất hiện ngay hai dòng phía trên mã thật. Cái nào xuất hiện trước sẽ thắng, và bài kiểm thử sẽ gõ nó vào biểu mẫu với sự tự tin tuyệt đối.

\D{0,12} chính là chi tiết mang tính thực dụng: sau khi các thẻ đã được thay bằng khoảng trắng, phần chữ và phần số có thể bị ngăn cách bởi một dấu hai chấm, một chuỗi khoảng trắng, hoặc phần còn sót lại của một thẻ <strong> từng nằm giữa chúng. Cho phép tối đa mười hai ký tự không phải chữ số sẽ bao trùm hết tất cả những trường hợp đó, mà không để mẫu biểu thức nhảy sang một con số khác.

Các template tách rời từng chữ số

Một kiểu thiết kế phổ biến đặt mỗi chữ số của mã vào một ô riêng, để đọc dễ hơn trên điện thoại. Trong HTML, đó là sáu ô bảng, hoặc sáu thẻ <span>, và con số đó không bao giờ xuất hiện dưới dạng sáu ký tự liên tiếp ở bất cứ đâu trong mã nguồn:

<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>

Một regex chạy trên HTML thô sẽ chẳng tìm thấy gì cả. Cách khắc phục không phải là một regex khôn khéo hơn; mà là chuyển HTML thành văn bản trước, theo một trình tự cố định:

1. Thay mọi thẻ bằng một khoảng trắng. Một khoảng trắng, chứ không phải không gì cả — <td>4</td><td>8</td> phải trở thành 4 8, chứ không phải 48 dính liền với bất cứ thứ gì theo sau.
2. Giải mã các thực thể. &,  , '. Một khoảng trắng không ngắt dòng nằm giữa hai chữ số sẽ không được một regex coi là khoảng trắng cho đến khi nó được giải mã.
3. Gộp khoảng trắng lại, rồi đối chiếu với các chữ số được phép cách nhau bởi khoảng trắng. Với kiểu thiết kế chia ô, dùng code is\D{0,12}(\d)\s*(\d)\s*(\d)\s*(\d)\s*(\d)\s*(\d) rồi nối các nhóm lại; còn với một template thông thường, mẫu biểu thức đơn giản ở phần trước là đủ.

Các helper bên dưới đã làm sẵn bước một và bước hai cho bạn, đồng thời tìm kiếm trên cả hai phần cùng lúc, nên một bài kiểm thử không cần phải biết template tháng này đang dùng kiểu thiết kế nào.

Thư mới nhất không phải lúc nào cũng là thư đúng

Mọi lượt liệt kê hộp thư ở đây đều trả về theo thứ tự mới nhất trước, và messages[0] là thứ mà phần lớn các bản nháp đầu tiên hay đọc lấy. Ba tình huống sau khiến đó trở thành thư sai:

Hai thư từ một hành động

Đăng ký gửi đi một thư chào mừng và một thư chứa mã, theo bất kỳ thứ tự nào mà hàng đợi của bên gửi xử lý xong trước. Một nửa số lần, thư chào mừng lại là thư mới nhất. Hãy lọc theo tiêu đề, hoặc theo người gửi, trước khi lấy bất cứ thư nào.

Một lượt gửi lại

Bài kiểm thử đã yêu cầu mã hai lần — một lần do nhầm lẫn, một lần có chủ đích — và máy chủ chỉ chấp nhận mã mới nhất. Thư cũ hơn vẫn còn nằm trong hộp thư, vẫn khớp với mẫu biểu thức, và vẫn phân tích ra được sáu chữ số, nhưng giờ đã không còn hợp lệ.

Một lượt chạy kiểm thử trước đó

Chỉ xảy ra nếu địa chỉ bị dùng lại, điều mà lẽ ra không bao giờ nên xảy ra. Một địa chỉ mới cho mỗi lượt chạy sẽ khiến trường hợp này không thể xảy ra; nếu bạn không thể có được điều đó, cách chụp lại trạng thái bên dưới sẽ là phương án dự phòng.

Hình dạng vững chắc của giải pháp này giống nhau ở mọi runner: nhìn xem hộp thư đang chứa gì trước khi bạn kích hoạt việc gửi thư, rồi chỉ chấp nhận một thư chưa từng có ở đó và khớp với tiêu đề bạn đang mong đợi.

// 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));

Những mã hết hạn ngay trong lúc chạy

Phần lớn mã dùng một lần có hiệu lực từ năm đến mười lăm phút. Nghe có vẻ rộng rãi, cho đến khi một bộ kiểm thử xếp hàng hai mươi spec, mỗi spec đều yêu cầu mã của mình ngay từ đầu rồi mới gõ nó vào ở cuối. Ba quy tắc sau giữ cho mã còn sống:

• Yêu cầu mã càng muộn càng tốt. Kích hoạt việc gửi ngay trước lúc chờ, chứ không phải trong một bước thiết lập chạy trong khi các bài kiểm thử khác vẫn đang xếp hàng.
• Giữ hạn chót chờ đợi thấp hơn hẳn thời gian sống của mã. Một hạn chót sáu mươi giây cho một mã có hiệu lực mười phút sẽ để lại chín phút để gõ nó vào. Một hạn chót mười phút thì chẳng để lại gì cả.
• Đừng bao giờ lưu một mã để dùng cho bài kiểm thử khác. Mã vừa chỉ dùng được một lần vừa có tuổi thọ ngắn; một fixture dùng chung phát ra một mã như vậy chẳng khác nào một cuộc chạy đua giữa hai bài kiểm thử để giành lấy cùng một con số.

Các bộ trích xuất sẵn sàng dùng ngay

Ba phiên bản của cùng bốn dòng lệnh: nối cả hai phần lại, đổi thẻ thành khoảng trắng, giải mã thực thể, gộp khoảng trắng, rồi áp dụng mẫu biểu thức đã được neo sẵn. Chỉ cần đổi mẫu biểu thức cho khớp với câu chữ trong template của bạn, không cần động vào gì khác.

Từ shell, dùng jq

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];
}

JSON của thư mà các đoạn code này đọc đến từ GET /api/v1/message/{id}, được ghi chép trong tài liệu tham chiếu API; còn việc chờ để có được id đó ngay từ đầu nằm trong hướng dẫn kiểm thử từ đầu đến cuối, cùng với các helper dựng sẵn cho Playwright, Cypress, Python và Node.js.

Trước khi bạn coi như đã xong

• Mẫu biểu thức được neo vào đúng câu chữ trong template của bạn, và được đặt ngay bên cạnh template đó.
• Cả hai phần đều được tìm kiếm, dưới dạng văn bản: thẻ chuyển thành khoảng trắng, thực thể được giải mã, khoảng trắng được gộp lại.
• Một bộ lọc theo tiêu đề hoặc người gửi, để một thư chào mừng không bao giờ thắng thế trước một thư chứa mã.
• Một lần chụp trạng thái trước bất kỳ lượt gửi lại nào, và chỉ những thư mới xuất hiện sau đó mới được chấp nhận.
• Hạn chót chờ đợi thấp hơn hẳn thời gian sống của mã, và việc gửi được kích hoạt ngay trước lúc chờ.
• Một thông báo lỗi nêu rõ id của thư và tiêu đề mà nó đã tìm trong đó.

Điều đó bao trùm mọi cách mà một bộ trích xuất sáu chữ số từng bị bắt gặp là cho qua một con số sai. Một agent đọc cùng loại thư đó cũng gặp đúng những vấn đề như vậy, nhưng lại có ít công cụ hơn để xử lý chúng, và đó chính là lý do máy chủ MCP đưa cho nó cả thư đầy đủ thay vì một phỏng đoán — bài một hộp thư mà AI agent có thể đọc được đi sâu vào điều đó.

Câu hỏi