[WS] Contains String


Verify that an expected text appeared in the returned data from a web service call.


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.


  • true, if your text is found; otherwise, false.


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)