Share this page

# web_global_verification

Check Functions

Searches for a text string in all subsequent requests.

    int web_global_verification( <List of Attributes>, LAST );

Argument | Description
--- | ---
List of Attributes | Text: The text string to search for. This attribute must be a non–empty, null–terminated character string. Use the format `"Text=`string`"`. You can further customize your search by using Text Flags. The following two attributes are used only when Text is not specified. TextPfx: The prefix of the text string for which you are searching. Use the format `"TextPfx=`string`"`. You can further customize your search by using Text Flags. TextSfx: The suffix of the text string for which you are searching. Use the format `"TextSfx=`string`"`. You can further customize your search by using Text Flags. Search: >Where to search for the text. The available values are Headers, Body, NORESOURCE, or All. The default is NORESOURCE. This attribute is optional. Use the format `"Search=`value`"`. Fail: The handling option when the string is not found The available values are Found (default) and NotFound. Found indicates that a failure occurs when the text is found (e.g., "Error"). NotFound indicates that a failure occurs when the text is not found. Use the format `"Fail=`value`"` ID: A identifying string used to denote this particular call to web_global_verification. For example, it is used in the log file and in calls to web_global_verification_pause.
LAST | A marker that indicates the end of the attribute list.

## Return Values

This function returns LR_PASS (0) on success, and LR_FAIL (1) on failure.

## Parameterization

The following arguments can be parameterized using standard parameterization: Text, TextPfx, and TextSfx

## General Information

The web_global_verification function registers a request to search for the specified text string in web pages return by all subsequent action functions. The script fails if the Fail condition occurs in any subsequent action function. This is in contrast to the web_reg_find function which only registers a request for the next Action function.

To suspend the check, use web_global_verification_pause. If more than one check is in force due to multiple calls to web_global_verification, call web_global_verification_pause for each check you want to suspend.

The web_global_verification function is useful in detecting application level errors that are not represented by HTTP status codes. To locate errors that are represented by HTTP status codes, use web_get_int_property.

You can search the body, headers, html code, or the entire contents of a page. The Search options are:

- all: the entire HTML page

- headers: only the its headers, not the body

- body: the body, excluding all headers, but including all resources

- NORESOURCE: only the html body, excluding all headers and resources (default)

If you do not know the exact text to search for, or if the text is not consistent, you can qualify it by its beginning and end, using the TextPfx and TextSfx attributes. The prefix and suffix are actually the boundaries of the text—TextSfx is the right boundary and TextPfx is the left boundary. When using these attributes, you must specify a non–empty value for both attributes, and the Text attributes must not be specified.

When "Fail = Found" is specified (or no Fail condition is specified) with TextPfx and TextSfx and the left and right boundaries are found more than once, each match is issued as an error up to the maximum number of errors configured in the Runtime Settings > Preferences > Advanced Options. Subsequent matches are logged as informational messages.

## Example 1

In the following example, web_global_verification searches for the text string "Acme Company". If the string is not found, it fails and the script execution stops.

    web_global_verification("Text/IC=Acme Company",
        "Fail=NotFound",
        "ID=FindAcme", LAST );

    web_url("Step", "URL=...", LAST );

The log error message with the "FindAcme" ID is:
Error -27127: "Text=Acme Company" not found for web_global_verification ("FindAcme")

## Example 2

In the following example, web_global_verification identifies the function name in the following string, `"Error in function` myfunc`: File not found"` where the function name varies. If it detects the error text, it fails: `(Fail=Found)`.

    web_global_verification("TextPfx=Error in function",
    	"TextSfx=File not found"
            "Fail=Found", LAST );

    web_url("Step", "URL=...", LAST );

Tips to improve your search results... VuGen Function Reference Version 26.1 Function Reference 26.1 All View Local Help Center View Online Help Center Version: