Extract Method (List(String), String, ActionType)

Response Extract Method (List String , String, ActionType)

C# API

Extracts text from the response content - everything between (but not including) the specified list of before and after string objects - returning an empty string if they cannot be found, and specifying what action to take in case of failure.

Namespace: Facilita.Web
Assembly: clrWebBrowser (in clrWebBrowser.dll) Version: 9.5.8.37 (1.0.0.0)

Syntax

C++

Copy to Clipboard Print

public string Extract(
	List<string> before,
	string after,
	ActionType failAction
)

public string Extract(
	List<string> before,
	string after,
	ActionType failAction
)

Parameters

before: Type: System.Collections.Generic List String
Each string in this List is searched for sequentially in the response content, and the returned string starts immediately after all the string objects have been matched in the content.

after: Type: System String
This text is searched for in the response content after the before text has been found, and the returned string ends immediately before this text occurs in the content.

failAction: Type: Facilita.Fc.Runtime ActionType
The action to take if the text cannot be found.

Return Value

The extracted text, or an empty string if the extract failed.

Remarks

Note
The search is case-sensitive.

Supplying a List<string> of before values enables you to express more complicated extraction patterns. eggPlant Performance searches for the first string in the list, and searches for the second string after the position at which the first string was found. This continues until the final string is matched, after which the extracted response content is returned until after is matched. See the example below, in which a known unique name (f_custid) is used to narrow the search.

Examples

The following example demonstrates using a list of strings to narrow down the search for text to extract from a HTML Response, and causing a warning to appear in the Virtual User event log if the text could not be found.

C++

Copy to Clipboard Print

Response response = request.Send();

// extract the f_custid value from the HTML text 
// <input type="text" name="f_customer" size="32" maxlength="32" value="Joe Smith"> 
// <input type="text" name="f_custid" size="10" maxlength="10" value="12345"> 
// <input type="text" name="f_account" size="10" maxlength="10" value="9876543">

List<string> before = new List<string>();
before.Add("f_custid");
before.Add("value=\"");

string extractedText = response.Extract(
                        before,
                        "\"",
                        ActionType.ACT_WARNING);

Response response = request.Send();

// extract the f_custid value from the HTML text 
// <input type="text" name="f_customer" size="32" maxlength="32" value="Joe Smith"> 
// <input type="text" name="f_custid" size="10" maxlength="10" value="12345"> 
// <input type="text" name="f_account" size="10" maxlength="10" value="9876543">

List<string> before = new List<string>();
before.Add("f_custid");
before.Add("value=\"");

string extractedText = response.Extract(
                        before,
                        "\"",
                        ActionType.ACT_WARNING);