應用場景

在API的測試中，有時候需求是對整個文件進行檢驗而不是某個特定的值，或者說要對某個特定的值在不同的用例中重復地進行驗證。這種狀況下，我們最喜歡用的就是變量。可以存取外部數據或定義內部變量，使代碼變得簡潔、又有可閱讀性，同時測試用例結果運行也能保持一致性。

學習要點

·如何讀取外部文件并進行文件內容的精確對比

·如何讀取外部文件并進行文件內容的模糊對比

·使用變量驗證某個特定的value是否出現

·使用變量驗證某個特定的key是否出現

示例中get url: https://reqres.in/api/users/2

準備工作

如果您想跟著以下示例操作，需要做好以下配置:

·測試框架: Java + Karate + Junit 5

·語言: Java, Cucumber

·IDE: Intellij IDEA

·項目類型: Maven

創建測試場景

1.創建feature文件: testvar-use.feature

2.創建用例

用例一：讀取外部文件并進行文件內容的精確對比

如下圖中測試場景：用例中發送了一個get的請求以后，期待回應的代碼是200，并列出相應的結果。代碼And match response == compareResponse 檢驗返回的結果與期待的結果是否一致 。在Background中代碼：* def compareResponse = read('classpath:src/test/resource/comparedContent.json') 定義了變量compareResponse 是讀取的文件comparedContent.json的內容。(注：* 符號實際上可以換作 Given, 讀取文件的路徑: classpath)

如下圖所示：comparedContent.json 內容是與 get請求返回的結果一致的。（注: json文件內容格式一定要正確，否則會出現讀取文件錯誤的信息，參看常見錯誤）

用例二：讀取外部文件并進行文件內容的模糊對比

代碼And match response == compareResponseIgnoreValue檢驗返回的結果與期待的結果是否一致 。在Background中定義變量compareResponseIgnoreValue是讀取的文件comparedContentIgnoreValue.json。與上例中所不同的是期待文件內容并不完全與返回的相一致。

在comparedContentIgnoreValue.json 中，與上一個用例對比，這里可以看到 "text": 的值換成了"#ignore"，當進行對比時，這個字段的內容會忽略。

用例三：使用變量驗證某個特定的value是否出現

在用例一、用例二中，同時出現了代碼：And match response.ad.url == adUrl ， 這里的adUrl 實際就是Background 中自定義變量 * def adUrl = 'http://statuscode.org/' 。

用例四：使用變量驗證某個特定的key是否出現

在下面的場景中，代碼And match response.ad.text != null 驗證了返回結果中ad下text 字段必須存在。

下面兩行代碼先定義了一個變量notPresentedKey 并且賦予對應的ad下keyNull的字段，然后再驗證notPresentedKey 不存在。這里的變量是必需的，否則會出現找不到路徑錯誤。（參看常見錯誤）

這個變量不能放在Background 在本示例中，因為response是發送get請求以后返回的結果，如果放在Background中，response 還沒有返回，引用就會有錯。（參看常見錯誤）

* def notPresentedKey = response.ad.keyNull

And match notPresentedKey == null

常見錯誤

1.文件讀取

用例一，用例二中，當json文件內容格式不正確時，就會現如下運行錯誤:

2.不使用變量驗證不存在的字段

在用例四中，如果直接用And match response.ad.keyNull == null, 會出現如下錯誤信息，這是因為在驗證的時候，會先尋找對應的路徑 ad.keyNull, 在返回的結果中是不存在ad.keyNull字段的。）

3.在Background中提前引用response

字段的匹配與寫法

如下圖所示的正確Json文件格式，整個返回的內容在karate中稱作 response。如果要想驗證data下的id字段，就可以引用 response.data.id。這里做些補充以免有些初學不清楚如何引用字段（其實這也是我開始學習時感到困惑的哦。）

結語

是不是變量特別好用啊，節省了很多寫代碼的時間哦，可以看到定義在Background 中的變量看作是全局變量，可以用在任意一個場景中。在某個場景中定義的變量可以說是局部變量。希望小伙伴們靈活靈用，為您的API 測試助力、加油。