Skip to main content

[WS] Contains String

Description

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

Keyword name: WS.containsString

Parameters

ParameterParameter TypeMandatoryDescription
responseResponseObjectrequiredThe object that represents an HTTP response
stringStringrequiredThe text you want to look for
useRegexBooleanrequiredIndicate whether the text is a regular expression
flowControlFailureHandlingoptionalSpecify 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)