Automation Guide Action-based testing language Built-in actions User Interface actions Browsing

 get popup default text

get popup default text

Description

Retrieve the default text of the user-entry field of one or more recent prompt popups.

Arguments

• message

  Identifying message text of prompt popup(s) of interest.

• variable, variable2, variable3,…,variableN (not necessarily sequential)

  (Optional) Names of one or more variables to receive the returned default text displayed in corresponding prompt popups.

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.

Notes

• Prior to using this built-in action, it is recommended that you become familiar with the different kinds of modal JavaScript popups and how to handle them properly.

  • For Safari
    • on iOS, refer to Handling JavaScript popups on Safari iOS for details.
    • on macOS, refer to Handling JavaScript popups on Safari macOS for details.
  • For Google Chrome on Android, refer to Handling JavaScript popups on Chrome Android for details.

• message argument:

  • If no value is provided in this argument, any prompt without a message is considered a match.

  • For added flexibility, wildcards may be used in this argument. For example: given a message argument with value of {Please reenter your.*}, TestArchitect searches for prompt popups whose message beginnings match the string Please reenter your. (See example below.)

    Tip: 
    In more general terms, this argument accepts regular expressions.

• variable argument:

  • For convenience, the argument headers variable, variable0 and variable1 are all used to reference the same item (that is, the default text of the most recent matching prompt popup).
  • Numbers appended to the variable arguments reference only prompts in the recent popup history that have messages matching the contents of the message argument. Any other prompts, for the purposes of the current action, are ignored. The numbers correspond to the reverse order in which those popups were handled. Hence,variable references the most recently handled prompt popup satisfying the message text,variable2 the second most recent, and so on. (See Example #2.)
  • In cases where multiple recent prompt popups satisfy the contents of message, a single call to this action can retrieve any or all of the respective default text strings. Specify as many variable arguments as there are texts you wish to retrieve, taking care to number them in correspondence with the specific matching prompts of interest. (See Example #2.)
  • If the variables in arguments variable, variable2, variable3, etc.have not been declared, the action creates them as globals.

• This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Applicable Built-In Settings

The following settings are applicable to this action: remove double quotes from cells, standard ASCII only.

Applicable Controls

This action is applicable to the following controls: none.

Example - Case 1: A single popup

Scenario: You are testing a customer information page with a button, Sign up, used for submitting one’s name:

1. Upon clicking the button, a prompt appears with one input field and two buttons: OK and Cancel.

   Notes: 
   The prompt popup displays the fields:
   • Message: Please enter your name
   • Default text: Joe Doe

2. The test enters a new input value, e.g. Jane Doe, and then clicks OK to proceed.

3. The test then retrieves the default text of the prompt popup based on a given message.

Action Lines

Result

Example - Case 2: A sequence of multiple popups

Scenario: You are testing an email registration page, with a button, Sign up, used for submitting a new email address:

1. Upon clicking the button, a prompt popup appears with one input field and two buttons: OK and Cancel.

   Notes: 
   This first prompt popup displays the following:
   • Message: Please enter your email address
   • Default text: Joe.doe@example.com

2. An invalid email address is entered (e.g. Doe), and then OK is clicked to proceed.

3. An alert popup is triggered to notify user of the invalid email address. It has one button, OK .

4. The test clicks OK in the alert to dismiss it and proceed.

5. An additional prompt popup appears emphasizing the need for a valid email address.

   Notes: 
   This second prompt popup displays:
   • Message: Please enter a valid email
   • Default text: Jane.doe@example.com

6. A valid email address, e.g. Jonnie.doe@gmail.com, is now entered, and OK clicked.

7. The test then retrieves the following default texts of the user-entry prompts:

   • The default text of the prompt popup whose message is Please enter a valid email.
   • The default text of the prompt popup whose message is Please enter your email address. (Hint: We can retrieve both default texts in a single action call by specifying prompts whose messages begin with the string Please enter)

Action Lines

Result

Related information

click on next popup

enter text on next popup

get popup message

check popup message

check popup default text

clear popup queue