Share this page

# web_image_check

Verifies the presence of a specified image inside an HTML page.

## C Language

    int web_image_check( const char *CheckName, <List of Attributes>, <"Alt=alt"|| "Src=src">, LAST);

Check Functions

## Java Language

    int object.image_check( String CheckName, String [] argumentList );

Check Functions | Java Syntax

Argument | Description
--- | ---
object | An expression evaluating to an object of type WebApi. Usually web for Java. See also Function and Constant Prefixes.
CheckName | The name of the image check, as it appears in the test tree.
List of Attributes | Supported Attribute: Frame: Defines the scope of the search in the case of multiple frames. Supported Options: Options are similar to attributes, but some of them allow only a pre–defined set of values. All other values are illegal. The allowed options are: expect, matchcase, repeat, report, and onfailure. See Supported Options below.
Alt | Checks for the ALT tag of the image. Empty Alt strings are illegal.
Src | Checks for the SRC tag of the image. Empty Src strings are illegal.
LAST | A marker that indicates the end of the field list.

## Return Values

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

## Parameterization

The following argument(s) can be parameterized using standard parameterization: List of Attributes, Alt, Src

## Supported Options

### expect

Defines that the check is successful if the script:

- Finds the specified search criteria.

– or –

- Does not find the specified search criteria.

For example, you may want to check that a specific error message does not appear on your web page.

Legal values:

found | Indicates that the check is successful if the script finds the specified search criteria.
notfound | Indicates that the check is successful if the scriptdoes not find the specified search criteria.

Default: found

### Matchcase

The matchcase option defines whether the search is case–sensitive or not.

### repeat

Defines whether the search should be continued after the first appearance of the search string is located. This option is useful when searching through a web page that may have multiple occurrences of the search string.

Legal values:

yes | Indicates that the search should be continued after the first appearance of the search string is located.
no | Indicates that the search should not be continued after the first appearance of the search string is located.

Default: yes

### report

Defines under what conditions VuGen displays the results of the checks in the Result Summary Report.

Legal values:

success | Displays check results only if the check succeeds.
failure | Displays check results only if the check fails.
always | Displays all check results irrespective of the outcome of the check.

Default:always

### onfailure

Determines whether the script instance should abort if the check fails.

Legal values:

abort | Indicates that the script should abort if the check fails, regardless of the error–handling method set in the runtime settings.

If Onfailure=abort is not specified, then the state of Continue on Error will determine what will happen in the event of a web_find step failing to find a text. See Error Handling for more information.

## General Information

The web_image_check function verifies the presence of a specified image inside an HTML page.

Either Alt or Src, or both, must be in the argument list. If both are passed, the check passes if both match a single image element.

This function is only supported for HTML–based scripts.

## C Example

In the following example, the web_image_check function looks for the image ALT text is "Venus" in the ImagesAndMaps page:

Copy code

    web_url("index.html", "URL=http://localhost/ImagesAndMaps.html",
        "TargetFrame=", LAST );

    web_image_check("Go2Venus", "Alt=Venus", LAST );

## Java Example

In the following example, the image_check function looks for the image ALT text is "Venus" in the ImagesAndMaps page:

Copy code

    try
    {
        web.url("index.html",
            "URL=http://localhost/ImagesAndMaps.html",
            new String [] {
                "TargetFrame=", "LAST"});
        web.image_check("Go2Venus",
            new String []{"Alt=Venus", web.LAST});
    }
    catch (Exception e) {}

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