自動化測試的核心在于驗(yàn)證——確認(rèn)應(yīng)用的行為是否符合預(yù)期。在Playwright測試中，斷言是這一驗(yàn)證過程的基石。然而，許多測試工程師在使用斷言時，往往只停留在基礎(chǔ)層面，未能充分利用Playwright提供的強(qiáng)大驗(yàn)證機(jī)制。本文將深入探討智能斷言與軟斷言的使用技巧，幫助你編寫更健壯、更易維護(hù)的測試腳本。

傳統(tǒng)斷言的局限性

在討論高級斷言技術(shù)之前，我們先看看傳統(tǒng)方法的問題。典型測試中，你可能寫過這樣的代碼：// 傳統(tǒng)斷言方式

await page.goto('https://example.com');
const title = await page.textContent('h1');
expect(title).toBe('Welcome to Our Site');
const button = await page.locator('button.submit');
expect(await button.isVisible()).toBe(true);

這種方式雖然有效，但存在幾個問題：

• 每個斷言都需要明確提取值再驗(yàn)證
• 一個斷言失敗會立即停止測試執(zhí)行
• 錯誤信息不夠直觀，需要額外調(diào)試

智能斷言：讓驗(yàn)證更簡潔

Playwright的智能斷言（Smart Assertions）通過自動等待和重試機(jī)制，顯著簡化了測試代碼。

1. 內(nèi)置的expect自動等待

Playwright對expect進(jìn)行了擴(kuò)展，使其能夠自動等待條件成立：

// 智能斷言示例
await expect(page.locator('h1')).toHaveText('Welcome to Our Site');
await expect(page.locator('button.submit')).toBeVisible();

這里的toHaveText和toBeVisible都會自動等待，直到元素滿足條件或超時。這消除了顯式等待的需要，使代碼更簡潔。

2. 常用智能斷言方法

// 文本內(nèi)容驗(yàn)證
await expect(page.locator('.status')).toHaveText('Success');
await expect(page.locator('.status')).toContainText('Success');

// 屬性驗(yàn)證
await expect(page.locator('input#email')).toHaveAttribute('type', 'email');
await expect(page.locator('img.logo')).toHaveAttribute('src', /logo\.png$/);

// CSS類驗(yàn)證
await expect(page.locator('button')).toHaveClass('btn btn-primary');
await expect(page.locator('alert')).toHaveClass(/success/);

// 元素狀態(tài)驗(yàn)證
await expect(page.locator('checkbox')).toBeChecked();
await expect(page.locator('input')).toBeEmpty();
await expect(page.locator('select')).toBeEnabled();

// 可見性與存在性
await expect(page.locator('.modal')).toBeVisible();
await expect(page.locator('.modal')).toBeHidden();
await expect(page.locator('non-existent')).toHaveCount(0);

3. 自定義等待選項(xiàng)

智能斷言允許配置等待行為：

// 自定義超時和間隔
await expect(page.locator('.loader')).toBeHidden({ 
  timeout: 10000, // 10秒超時
});

// 帶自定義錯誤信息
await expect(page.locator('h1'), '頁面標(biāo)題不正確')
  .toHaveText('Dashboard');

軟斷言：收集而非中斷

在復(fù)雜測試場景中，我們經(jīng)常需要驗(yàn)證多個條件，但又不希望第一個失敗就終止測試。這時軟斷言（Soft Assertions）就派上用場了。

1. 為什么需要軟斷言？

考慮一個用戶注冊表單的測試，我們需要驗(yàn)證：

• 表單標(biāo)題正確
• 所有必填字段存在
• 提交按鈕可用
• 錯誤提示初始隱藏

如果使用傳統(tǒng)斷言，第一個失敗就會阻止后續(xù)驗(yàn)證，你無法知道其他檢查點(diǎn)是否通過。

2. 實(shí)現(xiàn)軟斷言的幾種方式

方式一：使用try-catch收集錯誤

async function softAssert(testInfo, assertions) {
const errors = [];

for (const assertion of assertions) {
    try {
      await assertion();
    } catch (error) {
      errors.push(error.message);
    }
  }

if (errors.length > 0) {
    thrownewError(`軟斷言失?。篭n${errors.join('\n')}`);
  }
}

// 使用示例
await test.step('驗(yàn)證注冊表單', async () => {
const errors = [];

try {
    await expect(page.locator('h1')).toHaveText('用戶注冊');
  } catch (e) {
    errors.push(`標(biāo)題錯誤: ${e.message}`);
  }

try {
    await expect(page.locator('input[name="email"]')).toBeVisible();
  } catch (e) {
    errors.push(`郵箱字段缺失: ${e.message}`);
  }

// ... 更多斷言

if (errors.length > 0) {
    thrownewError(`表單驗(yàn)證失敗：\n${errors.join('\n')}`);
  }
});

方式二：使用第三方庫

// 使用chai-soft斷言庫
import { softAssertions } from'chai-soft';

// 配置軟斷言
softAssertions.configure({
failOnFirstError: false,
timeout: 5000
});

// 使用軟斷言
await softAssertions.expect(page.locator('h1')).toHaveText('正確標(biāo)題');
await softAssertions.expect(page.locator('.content')).toBeVisible();
// 所有斷言執(zhí)行完畢后檢查結(jié)果
softAssertions.verify();

方式三：使用Playwright Test的expect.soft()（新版本特性）

// Playwright 1.20+ 支持軟斷言
test('驗(yàn)證用戶儀表板', async ({ page }) => {
await page.goto('/dashboard');

// 使用軟斷言 - 所有都會執(zhí)行
await expect.soft(page.locator('h1')).toHaveText('用戶儀表板');
await expect.soft(page.locator('.welcome-msg')).toContainText('歡迎回來');
await expect.soft(page.locator('.stats-card')).toHaveCount(4);
await expect.soft(page.locator('.notification')).toBeVisible();

// 所有軟斷言執(zhí)行后，如果有失敗會匯總報(bào)告
// 測試會繼續(xù)執(zhí)行到這里

// 可以混合使用硬斷言
await expect(page.locator('body')).not.toHaveClass('error-mode');
});

3. 軟斷言的最佳實(shí)踐

test('完整的用戶配置驗(yàn)證', async ({ page }) => {
await page.goto('/user/profile');

// 第一組：基本信息驗(yàn)證
const basicInfoErrors = [];

try {
    await expect.soft(page.locator('#username')).toHaveValue('testuser');
  } catch (e) { basicInfoErrors.push('用戶名不匹配'); }

try {
    await expect.soft(page.locator('#email')).toHaveValue('user@example.com');
  } catch (e) { basicInfoErrors.push('郵箱不匹配'); }

// 第二組：偏好設(shè)置驗(yàn)證
const preferenceErrors = [];

try {
    await expect.soft(page.locator('#theme-dark')).toBeChecked();
  } catch (e) { preferenceErrors.push('主題設(shè)置錯誤'); }

try {
    await expect.soft(page.locator('#notifications-on')).toBeChecked();
  } catch (e) { preferenceErrors.push('通知設(shè)置錯誤'); }

// 生成詳細(xì)報(bào)告
if (basicInfoErrors.length > 0 || preferenceErrors.length > 0) {
    const report = [];
    if (basicInfoErrors.length) report.push(`基本信息: ${basicInfoErrors.join(', ')}`);
    if (preferenceErrors.length) report.push(`偏好設(shè)置: ${preferenceErrors.join(', ')}`);
    
    testInfo.annotations.push({
      type: 'soft-assert-failures',
      description: report.join(' | ')
    });
    
    // 根據(jù)失敗嚴(yán)重程度決定是否繼續(xù)
    if (basicInfoErrors.length > 2) {
      thrownewError(`關(guān)鍵信息驗(yàn)證失敗: ${report.join('; ')}`);
    }
  }
});

智能斷言與軟斷言的結(jié)合使用

在實(shí)際項(xiàng)目中，我們經(jīng)常需要混合使用兩種斷言策略：

test('電子商務(wù)下單流程', async ({ page }) => {
// 硬斷言：關(guān)鍵路徑必須通過
await page.goto('/product/123');
await expect(page.locator('.product-title')).toBeVisible();

// 添加到購物車
await page.click('button.add-to-cart');
await expect(page.locator('.cart-count')).toHaveText('1');

// 進(jìn)入結(jié)賬 - 硬斷言確保流程正確
await page.click('button.checkout');
await expect(page).toHaveURL(/\/checkout/);

// 結(jié)賬頁面多個驗(yàn)證點(diǎn) - 使用軟斷言收集所有問題
const checkoutIssues = [];

// 驗(yàn)證所有必填字段
const requiredFields = ['name', 'address', 'city', 'zip', 'card'];
for (const field of requiredFields) {
    try {
      await expect.soft(page.locator(`[name="${field}"]`)).toBeVisible();
    } catch (e) {
      checkoutIssues.push(`缺失字段: ${field}`);
    }
  }

// 驗(yàn)證價格計(jì)算
try {
    await expect.soft(page.locator('.subtotal')).toContainText('$99.99');
  } catch (e) { checkoutIssues.push('小計(jì)錯誤'); }

try {
    await expect.soft(page.locator('.tax')).toContainText('$8.00');
  } catch (e) { checkoutIssues.push('稅金錯誤'); }

try {
    await expect.soft(page.locator('.total')).toContainText('$107.99');
  } catch (e) { checkoutIssues.push('總計(jì)錯誤'); }

// 如果有驗(yàn)證問題但非致命，添加注釋繼續(xù)
if (checkoutIssues.length > 0 && checkoutIssues.length < 3) {
    console.log('結(jié)賬頁面警告:', checkoutIssues);
    // 繼續(xù)執(zhí)行...
  } elseif (checkoutIssues.length >= 3) {
    thrownewError(`結(jié)賬頁面嚴(yán)重問題: ${checkoutIssues.join(', ')}`);
  }

// 最終硬斷言：訂單提交成功
await page.click('button.place-order');
await expect(page.locator('.order-confirmation')).toBeVisible();
});

斷言策略的最佳實(shí)踐

分層使用斷言策略：

• 關(guān)鍵路徑使用硬斷言
• 多條件驗(yàn)證使用軟斷言
• 非關(guān)鍵檢查使用帶日志的軟斷言

合理配置超時：

// 根據(jù)元素重要性設(shè)置不同超時
await expect(page.locator('.login-form'), '登錄表單應(yīng)快速加載')
  .toBeVisible({ timeout: 5000 });
  
await expect(page.locator('.secondary-data'), '次要數(shù)據(jù)可稍慢')
  .toBeVisible({ timeout: 15000 });
增強(qiáng)斷言可讀性：// 使用自定義消息
await expect(
  page.locator('.user-avatar'), 
  '用戶應(yīng)已登錄并顯示頭像'
).toBeVisible();

// 使用測試步驟封裝
await test.step('驗(yàn)證購物車內(nèi)容', async () => {
  await expect.soft(page.locator('.cart-item')).toHaveCount(3);
  await expect.soft(page.locator('.cart-total')).toContainText('$299.97');
});
創(chuàng)建自定義斷言助手：class TestAssertions {
constructor(page) {
    this.page = page;
    this.softErrors = [];
  }

async softVerify(assertionFn, description) {
    try {
      await assertionFn();
    } catch (error) {
      this.softErrors.push(`${description}: ${error.message}`);
    }
  }

async assertAll() {
    if (this.softErrors.length > 0) {
      thrownewError(`驗(yàn)證失敗:\n${this.softErrors.join('\n')}`);
    }
  }
}

// 使用自定義助手
test('綜合驗(yàn)證', async ({ page }) => {
const assert = new TestAssertions(page);

await assert.softVerify(
    () => expect(page.locator('h1')).toHaveText('Dashboard'),
    '頁面標(biāo)題'
  );

await assert.softVerify(
    () => expect(page.locator('.widget')).toHaveCount(5),
    '小組件數(shù)量'
  );

// 執(zhí)行所有斷言后檢查
await assert.assertAll();
});

調(diào)試技巧：當(dāng)斷言失敗時

1. 利用豐富的錯誤信息： Playwright的智能斷言提供了詳細(xì)的錯誤信息，包括：

• 期望值與實(shí)際值
• 元素選擇器
• 等待時長
• 頁面截圖（如果配置了）

2. 失敗時自動截圖：

// 在配置文件中設(shè)置
// playwright.config.js
module.exports = {
use: {
    screenshot: 'only-on-failure',
  },
};

// 或針對特定測試
test('關(guān)鍵測試', async ({ page }) => {
  test.info().annotations.push({ type: 'test', description: '需要截圖' });

try {
    await expect(page.locator('.important')).toBeVisible();
  } catch (error) {
    await page.screenshot({ path: 'assertion-failure.png' });
    throw error;
  }
});

Playwright的斷言系統(tǒng)提供了從基礎(chǔ)到高級的完整驗(yàn)證解決方案。智能斷言通過自動等待簡化了測試代碼，而軟斷言則通過收集而非中斷的機(jī)制，提高了復(fù)雜場景的測試效率。
有效的斷言策略應(yīng)該是分層的：對關(guān)鍵功能使用立即失敗的硬斷言，對多條件驗(yàn)證使用收集錯誤的軟斷言。通過混合使用這兩種技術(shù)，并輔以自定義斷言助手和詳細(xì)的錯誤報(bào)告，你可以構(gòu)建出既健壯又易于維護(hù)的測試套件。
記住，好的斷言不僅僅是驗(yàn)證正確性，更是提供清晰、可操作的錯誤信息，幫助團(tuán)隊(duì)快速定位和解決問題?；〞r間優(yōu)化你的斷言策略，將在測試穩(wěn)定性和維護(hù)效率上獲得豐厚回報(bào)。