[WS] Contains String
Estimated reading time: 2 minutes
Description
Verify that an expected text appeared in the returned data from a web service call.
Parameters
| Parameter | Parameter Type | Mandatory | Description |
|---|---|---|---|
| response | ResponseObject | required | the object represents for a HTTP Response, user can get responded content type, data, header properties (sometime user may want to get cookie from response header) |
| string | String | required | the text you want to look for |
| useRegex | Boolean | required | indicate whether the text is a regular expression |
| flowControl | FailureHandling | optional | Specify failure handling schema to determine whether the execution should be allowed to continue or stop. |
Returns
- true, if your text is found; otherwise, false.
Example
You want to verify if the text “email@katalon.com” is in the data returned from “resObj”.
import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
import internal.GlobalVariable as GlobalVariable
import com.kms.katalon.core.testobject.ConditionType as ConditionType
import com.kms.katalon.core.testobject.RequestObject as RequestObject
import com.kms.katalon.core.testobject.TestObjectProperty as TestObjectProperty
import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WebAPI
import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile
import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS
import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint
import com.kms.katalon.core.model.FailureHandling as FailureHandling
import com.kms.katalon.core.testcase.TestCase as TestCase
import com.kms.katalon.core.testdata.TestData as TestData
import com.kms.katalon.core.testobject.TestObject as TestObject
import com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint
'Send a SOAP request and returns its response'
def resObj = WS.sendRequest(findTestObject('SOAP_EmployeeInfo'))
'Verify if response object contains email@katalon.com value'
WS.containsString(resObj, 'email@katalon.com', false)