命令行与文本处理 / 系统课时

编写 Pester 测试

编写 Pester 测试

本课通过一个订单金额函数,完整演示如何用 Pester 组织测试层级、编写断言,并分别验证正常结果与参数异常。完成后,你将得到一组可重复执行、失败原因清晰的单元测试。

学习目标

  • 使用 Describe、Context 和 It 组织测试用例
  • 使用 Should 断言验证返回值与异常
  • 运行测试并根据结果定位失败用例

认识测试层级

Describe 对应一个被测单元,Context 按输入条件或业务场景分组,It 描述一个可验证行为;断言通常写在 It 内。这样的层级能让测试报告直接呈现“哪个场景下的哪个行为失败”。:contentReference[oaicite:0]{index=0}

Pester 测试层级与正常、异常路径

编写被测函数

将下面内容保存为 Order.ps1。函数负责计算订单金额:标准会员按原价结算,金牌会员享受九折,同时通过参数验证拒绝无效数量和单价。

powershell
function Get-OrderTotal {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)]
        [ValidateRange(1, 100)]
        [int]$Quantity,

        [Parameter(Mandatory)]
        [ValidateScript({ $_ -gt 0 })]
        [decimal]$UnitPrice,

        [ValidateSet('Standard', 'Gold')]
        [string]$MemberLevel = 'Standard'
    )

    $total = $Quantity * $UnitPrice

    # 折扣规则集中在函数内部,测试只验证对外行为
    if ($MemberLevel -eq 'Gold') {
        return [math]::Round($total * 0.9, 2)
    }

    return [math]::Round($total, 2)
}

该脚本只定义函数,不主动产生控制台输出。验证方法是在同一目录创建测试文件并通过 Invoke-Pester 调用。

组织正常与异常路径

将下面内容保存为 Order.Tests.ps1。BeforeAll 只加载一次被测脚本;两个 Context 分别覆盖有效参数和无效参数,避免把不同失败原因混在同一组用例中。

powershell
BeforeAll {
    . "$PSScriptRoot/Order.ps1"
}

Describe 'Get-OrderTotal' {
    Context '参数有效' {
        It '标准会员返回原价' {
            $result = Get-OrderTotal -Quantity 2 -UnitPrice 100
            $result | Should -Be 200
        }

        It '金牌会员应用九折' {
            $result = Get-OrderTotal -Quantity 2 -UnitPrice 100 -MemberLevel Gold
            $result | Should -Be 180
        }
    }

    Context '参数无效' {
        It '数量为零时抛出验证异常' {
            { Get-OrderTotal -Quantity 0 -UnitPrice 100 } |
                Should -Throw '*Quantity*'
        }

        It '单价非正数时抛出验证异常' {
            { Get-OrderTotal -Quantity 1 -UnitPrice 0 } |
                Should -Throw '*UnitPrice*'
        }
    }
}

Should -Be 比较实际值与期望值,Should -Throw 则要求脚本块必须抛出异常。把异常调用包在 {} 中十分关键,否则异常会在断言接管前直接中断测试。

执行并判断结果

在两个文件所在目录运行测试。示例使用 Pester 的详细输出模式,便于查看每个 Context 和 It 的执行结果。

powershell
Invoke-Pester -Path ./Order.Tests.ps1 -Output Detailed

预期输出

text
Describing Get-OrderTotal
 Context 参数有效
   [+] 标准会员返回原价
   [+] 金牌会员应用九折
 Context 参数无效
   [+] 数量为零时抛出验证异常
   [+] 单价非正数时抛出验证异常
Tests completed in <TIME>
Tests Passed: 4, Failed: 0, Skipped: 0

<TIME> 会随机器性能和 Pester 版本变化。只要四个用例全部通过且失败数为零,就说明正常路径与异常路径均符合当前规则。

关键边界

每个 It 应只验证一个明确行为,名称要能表达输入条件和预期结果。测试数据应固定且可读,避免使用当前时间、随机数或真实网络响应,否则同一测试可能在不同运行中得到不同结论。

当生产规则发生变化时,应先修改或新增对应测试,再调整实现。不要为了让测试“变绿”而删除异常路径,因为参数验证往往正是脚本进入生产环境后的安全边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写 Pester 测试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通