Share this page

# lr.unmask

Unmasks an encoded string during replay.

Example | String and Parameter Functions

## Syntax

    lr.unmask( EncodedString );

## Arguments

Argument | Comments
--- | ---
EncodedString | The encoded string to unmask.

The lr.unmask function is generated during recording to encode passwords. VuGen records the actual password but displays an encoded version of the password within the lr.unmask function. You can also manually add an lr.unmask function call by right-clicking the string in the script and selecting Mask String. The resulting EncodedString argument is the original string after encoding.

When you run the script, the test run component unmasks the password. Each time you record, VuGen encodes the password differently, even when you use the same password.

To get an encoded value for later use, copy the value. Then go to Windows Start menu > Password Encoder. Paste the value into the Password field, and click Generate. The masked string appears in the Encoded String box. Click Copy and paste the masked string into a parameter for later use, or assign the value to a string variable.

## Return Values

Returns the decoded string. On error, returns null.

## Parameterization

Parameterization is not applicable to the argument of this function. To apply parameterization, use lr.evalString.

## Example

    lr.outputMessage(lr.unmask("38620da61ca1093e7aa7ec"));

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