feat(测试): 添加详细测试脚本并优化网络测试

- 在scripts.json中添加test:detailed脚本用于详细输出测试结果
- 在Pester配置中添加Filter模块排除Slow标签测试
- 优化网络测试脚本，减少重复查询端口操作
- 为网络测试添加Slow标签并调整测试超时时间

Author: mudssky

PesterConfiguration.ps1

@@ -31,6 +31,11 @@ $config = @{
             MaxThreads = 4
         }
     }
+
+    # Filter 模块: 定义筛选规则
+    Filter       = @{
+        ExcludeTag = @('Slow')
+    }
     CodeCoverage = @{
         Enabled                 = $true
         Path                    = "./psutils/modules/*.psm1"
@@ -45,6 +50,10 @@ $config = @{
         )
 
     }
+    Output       = @{
+        # 使用详细输出，方便查看哪些测试被跳过了
+        # Verbosity = 'Detailed'
+    }
     TestResult   = @{
         Enabled    = $true
         OutputPath = "./testResults.xml"

psutils/tests/network.Tests.ps1

@@ -9,19 +9,19 @@
 BeforeAll {
     # 导入被测试的模块
     Import-Module "$PSScriptRoot\..\modules\network.psm1" -Force
+    
+    # 预先获取一个被占用的端口，避免在每个测试中重复查询
+    $script:occupiedPort = Get-NetTCPConnection | Where-Object { $_.State -eq "Listen" } | Select-Object -First 1 -ExpandProperty LocalPort
 }
 
-Describe "Test-PortOccupation 函数测试" {
+Describe "Test-PortOccupation 函数测试" -Tag 'Network', 'Slow' {
     Context "端口占用检测" {
         It "应该能够检测到已占用的端口" {
-            # 测试一个通常被占用的端口（如果存在）
-            # 这里使用一个动态方法来找到一个被占用的端口
-            $occupiedPort = Get-NetTCPConnection | Where-Object { $_.State -eq "Listen" } | Select-Object -First 1 -ExpandProperty LocalPort
-            
-            if ($occupiedPort) {
-                $result = Test-PortOccupation -Port $occupiedPort
+            if ($script:occupiedPort) {
+                $result = Test-PortOccupation -Port $script:occupiedPort
                 $result | Should -Be $true
-            } else {
+            }
+            else {
                 # 如果没有找到被占用的端口，跳过此测试
                 Set-ItResult -Skipped -Because "没有找到被占用的端口进行测试"
             }
@@ -42,19 +42,17 @@ Describe "Test-PortOccupation 函数测试" {
     }
 }
 
-Describe "Get-PortProcess 函数测试" {
+Describe "Get-PortProcess 函数测试" -Tag 'Network', 'Slow' {
     Context "进程信息获取" {
         It "应该能够获取占用端口的进程信息" {
-            # 找到一个被占用的端口
-            $occupiedPort = Get-NetTCPConnection | Where-Object { $_.State -eq "Listen" } | Select-Object -First 1 -ExpandProperty LocalPort
-            
-            if ($occupiedPort) {
-                $result = Get-PortProcess -Port $occupiedPort
+            if ($script:occupiedPort) {
+                $result = Get-PortProcess -Port $script:occupiedPort
                 ($result) | Should -Not -Be $null
-                $result.Port | Should -Be $occupiedPort
+                $result.Port | Should -Be $script:occupiedPort
                 $result.ProcessId | Should -BeGreaterThan 0
                 $result.ProcessName | Should -Not -BeNullOrEmpty
-            } else {
+            }
+            else {
                 Set-ItResult -Skipped -Because "没有找到被占用的端口进行测试"
             }
         }
@@ -67,54 +65,51 @@ Describe "Get-PortProcess 函数测试" {
         }
 
         It "返回的对象应该包含所有必需的属性" {
-            # 找到一个被占用的端口
-            $occupiedPort = Get-NetTCPConnection | Where-Object { $_.State -eq "Listen" } | Select-Object -First 1 -ExpandProperty LocalPort
-            
-            if ($occupiedPort) {
-                $result = Get-PortProcess -Port $occupiedPort
+            if ($script:occupiedPort) {
+                $result = Get-PortProcess -Port $script:occupiedPort
                 if ($result) {
                     $result.PSObject.Properties.Name | Should -Contain "Port"
                     $result.PSObject.Properties.Name | Should -Contain "ProcessId"
                     $result.PSObject.Properties.Name | Should -Contain "ProcessName"
                     $result.PSObject.Properties.Name | Should -Contain "Path"
                     $result.PSObject.Properties.Name | Should -Contain "CommandLine"
                 }
-            } else {
+            }
+            else {
                 Set-ItResult -Skipped -Because "没有找到被占用的端口进行测试"
             }
         }
     }
 }
 
-Describe "Wait-ForURL 函数测试" {
+Describe "Wait-ForURL 函数测试" -Tag 'Network', 'Slow' {
     Context "URL 可达性测试" {
-        It "应该能够检测到可达的URL" {
-            # 测试一个通常可达的URL（如果网络连接正常）
-            $result = Wait-ForURL -DevToolsUrl "http://www.google.com" -Timeout 10 -Interval 1
-            # 注意：这个测试可能因为网络环境而失败，所以我们不强制要求结果
+        It "应该返回布尔值类型" {
+            # 测试函数返回值类型，使用快速超时和短间隔避免长时间等待
+            $result = Wait-ForURL -DevToolsUrl "http://localhost:99999" -Timeout 1 -Interval 0.5
             $result | Should -BeOfType [bool]
         }
 
         It "应该对不可达的URL返回false" {
-            # 使用一个不存在的本地地址
-            $result = Wait-ForURL -DevToolsUrl "http://localhost:99999" -Timeout 5 -Interval 1
+            # 使用一个不存在的本地地址，快速超时和短间隔
+            $result = Wait-ForURL -DevToolsUrl "http://localhost:99999" -Timeout 1 -Interval 0.5
             $result | Should -Be $false
         }
 
         It "应该正确处理超时" {
-            # 测试超时功能
+            # 测试超时功能，使用更短的超时时间和间隔
             $startTime = Get-Date
-            $result = Wait-ForURL -DevToolsUrl "http://localhost:99998" -Timeout 3 -Interval 1
+            $result = Wait-ForURL -DevToolsUrl "http://localhost:99998" -Timeout 1 -Interval 0.5
             $endTime = Get-Date
             $elapsed = ($endTime - $startTime).TotalSeconds
 
             $result | Should -Be $false
-            $elapsed | Should -BeGreaterOrEqual 3
-            $elapsed | Should -BeLessThan 5  # 允许一些误差
+            $elapsed | Should -BeGreaterOrEqual 1
+            $elapsed | Should -BeLessThan 2  # 允许一些误差
         }
 
         It "应该使用默认参数" {
-            # 测试默认参数
+            # 测试默认参数，使用快速超时
             { Wait-ForURL -Timeout 1 } | Should -Not -Throw
         }
     }

scripts.json

@@ -1,6 +1,7 @@
 {
   "scripts": {
     "install": "pwsh -File ./install.ps1",
-    "test": "Invoke-Pester -Configuration ( ./PesterConfiguration.ps1 )"
+    "test": "Invoke-Pester -Configuration ( ./PesterConfiguration.ps1 )",
+    "test:detailed": "Invoke-Pester -Output Detailed"
   }
 }