6、postman生成測(cè)試報(bào)告

環(huán)境準(zhǔn)備

1. 環(huán)境安裝介紹

• 安裝流程：生成測(cè)試報(bào)告需要先安裝node.js，再通過(guò)node.js安裝newman插件，最后安裝newman-reporter-htmlextra擴(kuò)展插件。
• 前提條件：Postman本身不能生成測(cè)試報(bào)告，必須借助newman插件實(shí)現(xiàn)。

2. 安裝newman

1）安裝node.js

• 安裝方法：雙擊.msi安裝包，勾選接受用戶(hù)協(xié)議，不做任何設(shè)置，一路"下一步"即可完成安裝。
• 驗(yàn)證方法：cmd打開(kāi)命令提示符，輸入命令npm -v，如能查看到npm的版本號(hào)信息則說(shuō)明安裝成功。
• 注意事項(xiàng)：安裝過(guò)程中不要勾選任何額外選項(xiàng)，保持默認(rèn)設(shè)置即可。
• 下載位置：官方下載地址為https://nodejs.org/zh-cn/download/，課程已提供安裝包可跳過(guò)下載步驟。

2）安裝newman

• 安裝命令：npm install -g newman，必須使用"管理員"身份啟動(dòng)命令提示符執(zhí)行。
• 安裝技巧：避開(kāi)網(wǎng)絡(luò)訪問(wèn)高峰期（早7:30-9:30，午11:30-14:30，晚18:30-22:30）可提高成功率。
• 驗(yàn)證方法：安裝完成后使用newman -v命令查看版本號(hào)確認(rèn)安裝成功。
• 異常處理：如安裝失敗可嘗試10幾次或幾十次，Windows終端有缺陷，安裝過(guò)程中不要用鼠標(biāo)點(diǎn)擊終端頁(yè)面。

3）安裝newman-reporter-htmlextra

• 安裝命令：npm install -g newman-reporter-htmlextra，同樣需要使用管理員權(quán)限。
• 安裝特點(diǎn)：只要newman安裝成功，此插件一定能安裝成功，如失敗可多嘗試幾次。
• 驗(yàn)證方法：通過(guò)后續(xù)生成測(cè)試報(bào)告的操作來(lái)驗(yàn)證插件是否安裝成功。

3. 安裝node.js總結(jié)

• 關(guān)鍵步驟：
  • 安裝node.js（雙擊.msi文件，一路下一步）
  • 驗(yàn)證node.js（npm -v查看版本）
  • 安裝newman（npm install -g newman）
  • 驗(yàn)證newman（newman -v查看版本）
  • 安裝htmlextra插件（npm install -g newman-reporter-htmlextra）
• 離線安裝方案：對(duì)于1%無(wú)法在線安裝的情況：
  • 找到C:\Users\用戶(hù)名\AppData\Roaming\npm目錄
  • 刪除原npm目錄所有內(nèi)容
  • 將npm.rar壓縮包內(nèi)容解壓到該目錄

 

用例集導(dǎo)入導(dǎo)出：

一、用例集的導(dǎo)出和導(dǎo)入

1. 導(dǎo)出用例集

1）導(dǎo)出用力集

• 操作步驟：
  • 選擇要導(dǎo)出的用例集名稱(chēng)
  • 點(diǎn)擊三個(gè)點(diǎn)選擇"export"選項(xiàng)
  • 默認(rèn)選項(xiàng)直接點(diǎn)擊export即可
• 文件格式：
  • 自動(dòng)生成.json后綴的文件
  • 文件名不建議修改，保持自動(dòng)命名格式
• 注意事項(xiàng)：
  • 導(dǎo)出前建議先創(chuàng)建專(zhuān)用目錄（如report）
  • 避免將文件隨意存放在桌面

2）選擇導(dǎo)出用力集

• 版本確認(rèn)：
  • 彈出頁(yè)面會(huì)顯示Collection v2.1（推薦版本）
  • 通常保持默認(rèn)選項(xiàng)不做修改
• 導(dǎo)出操作：
  • 直接點(diǎn)擊頁(yè)面下方的export按鈕
  • 系統(tǒng)會(huì)自動(dòng)生成用例集文件

3）選擇存儲(chǔ)位置

• 目錄準(zhǔn)備：
  • 建議新建專(zhuān)用文件夾（如report）
  • 避免使用中文命名
• 存儲(chǔ)操作：
  • 選擇預(yù)先準(zhǔn)備好的目錄
  • 保持自動(dòng)生成的文件名不變
  • 點(diǎn)擊"存儲(chǔ)"完成導(dǎo)出
• 成功提示：
  • 出現(xiàn)綠色提示表示導(dǎo)出成功
  • 可在指定目錄查看導(dǎo)出的.json文件

2. 導(dǎo)入用例集

1）刪除用例集

• 刪除步驟：
  • 點(diǎn)擊用例集名稱(chēng)旁的三個(gè)點(diǎn)
  • 選擇"delete"選項(xiàng)
  • 確認(rèn)刪除操作
• 注意事項(xiàng)：
  • 刪除前確保已備份重要用例集
  • 可批量刪除不需要的測(cè)試集

2）導(dǎo)入用例集

• 導(dǎo)入步驟：
  • 點(diǎn)擊界面上的"import"按鈕
  • 選擇"upload file"選項(xiàng)
  • 瀏覽選擇要導(dǎo)入的.json文件
• 注意事項(xiàng)：
  • 導(dǎo)入文件必須是Postman導(dǎo)出的.json格式
  • 可一次導(dǎo)入多個(gè)用例集文件

3）選擇導(dǎo)入文件

• 文件選擇：
  • 瀏覽到之前導(dǎo)出的用例集文件
  • 支持從任意位置選擇文件
  • 可同時(shí)選擇多個(gè)文件批量導(dǎo)入
• 操作提示：
  • 點(diǎn)擊"打開(kāi)"開(kāi)始導(dǎo)入
  • 系統(tǒng)會(huì)自動(dòng)識(shí)別文件格式

4）二次確認(rèn)步驟

• 重復(fù)導(dǎo)入處理：
  • 當(dāng)用例集已存在時(shí)會(huì)出現(xiàn)提示
  • 可選擇"Replace"替換原有用例集
  • 或選擇"Import as Copy"創(chuàng)建副本
• 推薦做法：
  • 通常選擇創(chuàng)建副本保留原有數(shù)據(jù)
  • 副本會(huì)自動(dòng)在原名稱(chēng)后添加"Copy"
• 完成提示：
  • 導(dǎo)入成功后會(huì)有相應(yīng)提示
  • 用例集會(huì)出現(xiàn)在左側(cè)導(dǎo)航欄

 

環(huán)境文件導(dǎo)出

1. 導(dǎo)出用例集

• 必要性：生成測(cè)試報(bào)告必須要有用例集文件，這是基礎(chǔ)條件
• 導(dǎo)出方法：
  • 在Postman中選擇要導(dǎo)出的用例集
  • 點(diǎn)擊"Export"按鈕導(dǎo)出為JSON格式文件
  • 默認(rèn)文件名格式為"xxx.postman_collection.json"
• 存儲(chǔ)建議：強(qiáng)烈建議將導(dǎo)出的用例集文件存放在專(zhuān)門(mén)目錄中，便于后續(xù)管理

2. 導(dǎo)出環(huán)境文件

1）環(huán)境文件的導(dǎo)出方法

• 前提條件：
  • 必須性：當(dāng)測(cè)試用例腳本中使用到環(huán)境變量時(shí)，必須導(dǎo)出環(huán)境文件
  • 區(qū)別：全局變量不需要導(dǎo)出，只有環(huán)境變量需要導(dǎo)出
• 操作步驟：
  • 進(jìn)入Postman的"Environments"標(biāo)簽頁(yè)
  • 選中當(dāng)前使用的環(huán)境（如測(cè)試環(huán)境）
  • 點(diǎn)擊右側(cè)三個(gè)點(diǎn)的菜單按鈕
  • 選擇"Export"選項(xiàng)導(dǎo)出環(huán)境文件

2）操作示例

• 文件命名：
  • 默認(rèn)生成"xxx.postman_environment.json"格式文件名
  • 強(qiáng)烈建議保留默認(rèn)命名，便于識(shí)別文件類(lèi)型
• 存儲(chǔ)位置：
  • 強(qiáng)烈建議與用例集文件存放在同一目錄下
  • 優(yōu)點(diǎn)：方便后續(xù)生成測(cè)試報(bào)告時(shí)命令編寫(xiě)，避免使用絕對(duì)路徑
• 變量修改示例：
  • 將全局變量改為環(huán)境變量：pm.globals.set()改為pm.environment.set()
  • 變量命名建議：使用"env_"前綴（如env_city）提高可讀性

3）操作示例

• 文件區(qū)分：
  • 用例集文件：包含"collection"標(biāo)識(shí)（如xxx.postman_collection.json）
  • 環(huán)境文件：包含"environment"標(biāo)識(shí)（如xxx.postman_environment.json）
• 實(shí)際應(yīng)用：
  • 環(huán)境變量使用前必須確保對(duì)應(yīng)環(huán)境被選中（如測(cè)試環(huán)境）
  • 示例：查詢(xún)天氣接口將城市名存入環(huán)境變量，百度搜索接口從環(huán)境變量讀取城市名
• 驗(yàn)證方法：
  • 通過(guò)Postman的眼睛圖標(biāo)查看當(dāng)前環(huán)境變量值
  • 確保變量值正確后再執(zhí)行依賴(lài)該變量的請(qǐng)求

 

測(cè)試報(bào)告生成命令詳解

1. 命令介紹

• 準(zhǔn)備工作：安裝node.js、安裝newman插件、導(dǎo)出用例集文件和環(huán)境文件，這些操作都是為生成測(cè)試報(bào)告做準(zhǔn)備。
• 生成方式：必須通過(guò)命令行生成，Postman工具本身不提供圖形化生成報(bào)告的功能。

2. 命令說(shuō)明

• 完整命令：
• 參數(shù)說(shuō)明：
  • run xxx.json：執(zhí)行測(cè)試集文件（必需）
  • -e source：指定環(huán)境變量文件（當(dāng)腳本使用環(huán)境變量時(shí)需要）
  • -d source：指定測(cè)試數(shù)據(jù)文件（當(dāng)用例使用參數(shù)化時(shí)需要）
  • -r htmlextra：指定生成HTML格式報(bào)告（固定寫(xiě)法）
  • --reporter-html-export source：指定報(bào)告保存路徑
• 參數(shù)取舍原則：
  • 測(cè)試集文件必須指定
  • 僅當(dāng)腳本中使用環(huán)境變量時(shí)才需要-e參數(shù)
  • 僅當(dāng)用例使用參數(shù)化時(shí)才需要-d參數(shù)
  • 示例：作業(yè)三（登錄模塊）不需要環(huán)境文件參數(shù)，但關(guān)聯(lián)練習(xí)需要環(huán)境文件參數(shù)
• 注意事項(xiàng)：
  • 命令中的htmlextra是固定寫(xiě)法，不能寫(xiě)錯(cuò)
  • 參數(shù)之間需要用空格分隔
  • 報(bào)告名稱(chēng)可以自定義，但擴(kuò)展名需為.html
  • 環(huán)境文件和用例集文件都是.json格式
• 文件示例：
  • 用例集文件：postman關(guān)聯(lián)練習(xí)1.collection.json
  • 環(huán)境文件：environment.json
  • 生成命令示例（無(wú)數(shù)據(jù)文件）：

三、命令總結(jié)

• 完整命令格式：
• 參數(shù)說(shuō)明：
  • -e參數(shù)：指定環(huán)境變量文件，當(dāng)測(cè)試不使用環(huán)境變量時(shí)可省略
  • -d參數(shù)：指定測(cè)試數(shù)據(jù)文件（支持.json或.csv格式），用于參數(shù)化測(cè)試，無(wú)參數(shù)化需求時(shí)可省略
  • -r參數(shù)：必須參數(shù)，指定生成報(bào)告類(lèi)型為htmlextra（擴(kuò)展版HTML報(bào)告）
  • --reporter-htmlextra-export：必須參數(shù)，由三個(gè)單詞組成，注意前面需要雙橫杠
• 執(zhí)行要點(diǎn)：
  • 必須保留newman run：不能省略"newman"或"run"關(guān)鍵字，否則命令無(wú)法執(zhí)行
  • 參數(shù)順序敏感：各參數(shù)位置不可隨意調(diào)換，必須保持固定格式
  • 空格要求：每個(gè)參數(shù)前必須有空格分隔，如"-e"前必須有空格

四、今日總結(jié)

• 關(guān)鍵步驟：
  • 前置準(zhǔn)備：需先安裝node.js和newman（通過(guò)npm install -g newman）
  • 插件安裝：必須安裝HTML報(bào)告擴(kuò)展插件（newman-reporter-htmlextra）
  • 文件管理：建議將環(huán)境文件、用例集文件存放在同一目錄下
• 注意事項(xiàng)：
  • 報(bào)告生成失敗排查：檢查是否漏寫(xiě)"newman"關(guān)鍵字或參數(shù)格式錯(cuò)誤
  • 參數(shù)化測(cè)試：當(dāng)使用數(shù)據(jù)文件時(shí)，必須確保文件格式正確（.json或.csv）
  • 路徑問(wèn)題：文件路徑包含空格或特殊字符時(shí)建議使用引號(hào)包裹

 

生成測(cè)試報(bào)告：

一、使用命令生成測(cè)試報(bào)告

1. 打開(kāi)終端

• 目錄操作技巧：
  • 建議為用例集和數(shù)據(jù)文件創(chuàng)建專(zhuān)用目錄存放
  • 在目錄地址欄直接輸入cmd可快速在當(dāng)前目錄打開(kāi)終端
• 路徑處理要點(diǎn)：
  • 必須確保終端在當(dāng)前用例集所在目錄打開(kāi)
  • 相對(duì)路徑寫(xiě)法要求終端必須定位到用例集所在目錄

2. 鞏固命令

• 基礎(chǔ)語(yǔ)法：
  • 完整格式：newman run 用例集文件.json -e 環(huán)境文件.json -d 數(shù)據(jù)文件.csv -r htmlextra --reporter-htmlextra-export 報(bào)告名.html
  • 參數(shù)說(shuō)明：
    • -e：非必須，僅當(dāng)使用環(huán)境文件時(shí)需要
    • -d：非必須，僅當(dāng)做參數(shù)化需要數(shù)據(jù)文件時(shí)使用
    • -r：必須指定為htmlextra格式
• 自動(dòng)補(bǔ)全技巧：
  • 在正確目錄打開(kāi)終端后，可使用tab鍵自動(dòng)補(bǔ)全文件名
  • 補(bǔ)全前提：必須確保文件存在于當(dāng)前終端所在目錄

• 例題:指定用例集文件和數(shù)據(jù)文件
  • 典型場(chǎng)景：
    • 當(dāng)測(cè)試需要參數(shù)化數(shù)據(jù)但不需要環(huán)境變量時(shí)使用
    • 示例命令：newman run 第三天作業(yè).postman_collection.json -d login.json -r htmlextra --reporter-htmlextra-export 作業(yè)測(cè)試報(bào)告.html
  • 執(zhí)行驗(yàn)證：
    • 成功執(zhí)行后會(huì)生成HTML格式測(cè)試報(bào)告
    • 報(bào)告默認(rèn)保存在用例集相同目錄下
    • 可查看請(qǐng)求詳情、響應(yīng)數(shù)據(jù)和斷言結(jié)果
• 例題:指定用例集文件和環(huán)境文件
   
  • 典型場(chǎng)景：
    • 當(dāng)測(cè)試需要環(huán)境變量但不需要參數(shù)化數(shù)據(jù)時(shí)使用
    • 示例命令：newman run postman關(guān)聯(lián)練習(xí)1.postman_collection.json -e 測(cè)試環(huán)境.postman_environment.json -r htmlextra --reporter-htmlextra-export 關(guān)聯(lián)練習(xí)報(bào)告.html
  • 注意事項(xiàng)：
    • 環(huán)境文件中需正確定義變量
    • 無(wú)斷言時(shí)報(bào)告僅顯示請(qǐng)求執(zhí)行情況
    • 可通過(guò)迭代詳情查看環(huán)境變量傳遞過(guò)程
  • 常見(jiàn)問(wèn)題排查：
    • 插件未安裝時(shí)會(huì)出現(xiàn)"command not found"錯(cuò)誤
    • 網(wǎng)絡(luò)延遲可能導(dǎo)致報(bào)告生成緩慢
    • 文件路徑錯(cuò)誤是最常見(jiàn)的執(zhí)行失敗原因