To learn more about using JavaScript in LeanFT, see Setting up and working with the JavaScript SDK.
For JavaScript code samples, see Code Samples - JavaScript.

NumericField

Web. NumericField

new NumericField(propsopt) → {NumericField}

The description of a Web NumericField test object.
Parameters:
Name Type Attributes Description
props Object <optional>
Initializes the description using the supplied property bag.
Returns:
the description object that was initialized.
Type
NumericField

Methods

absoluteLocation(locationopt) → {Point|Description}

The object's absolute coordinates relative to the screen (in pixels). 0,0 is always the top-left corner of the (primary) monitor.
Parameters:
Name Type Attributes Description
location Point <optional>
When provided, this method acts as a setter and sets the absoluteLocation value.
Returns:
If no parameter is provided, the method acts as a getter and returns the absoluteLocation value; otherwise it returns 'this' for use with the builder pattern.
Type
Point | Description

accessibilityName(valueopt) → {string|Description}

The label of the object (where no text label is available).
Parameters:
Name Type Attributes Description
value string <optional>
When provided, this method acts as a setter and sets the accessibilityName value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored accessibilityName value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

attributes(attributesopt) → {Object|Description}

The object's DOM attributes.
Parameters:
Name Type Attributes Description
attributes Object <optional>
When provided, this method acts as a setter and sets the attributes value. Specify the attribute names as object keys and set their values to the desired attribute values.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored attrs object; otherwise it returns 'this' for use with the builder pattern.
Type
Object | Description

className(nameopt) → {string|Description}

The object's CSS class (className property).
Parameters:
Name Type Attributes Description
name string <optional>
When provided, this method acts as a setter and sets the className value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored className value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

css(selectoropt) → {string|Description}

The path to this object in CSS format. For example: tr.BPTRow input.
Parameters:
Name Type Attributes Description
selector string <optional>
When provided, this method acts as a setter and sets the css value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored css value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

defaultValue(defaultValueopt) → {number|Description}

The default value in the edit field.
Parameters:
Name Type Attributes Description
defaultValue number <optional>
When provided, this method acts as a setter and sets the defaultValue value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored defaultValue value; otherwise it returns 'this' for use with the builder pattern.
Type
number | Description

id(idopt) → {string|Description}

The object's HTML identifier.
Parameters:
Name Type Attributes Description
id string <optional>
When provided, this method acts as a setter and sets the HTML id value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored HTML id value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

index(valueopt) → {Number|Description}

The 0-based index of this object, relative to all other objects with an otherwise identical description.
Parameters:
Name Type Attributes Description
value Number <optional>
When provided, this method acts as a setter and sets the index to the specified value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored index; otherwise it returns 'this' for use with the builder pattern.
Type
Number | Description

innerHTML(innerHTMLopt) → {string|Description}

The HTML code contained between the object's start and end tags.
Parameters:
Name Type Attributes Description
innerHTML string <optional>
When provided, this method acts as a setter and sets the innerHTML value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored innerHTML value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

innerText(innerTextopt) → {string|Description}

The text contained between the object's start and end tags.
Parameters:
Name Type Attributes Description
innerText string <optional>
When provided, this method acts as a setter and sets the innerText value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored innerText value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

isReadOnly(readOnlyopt) → {bool|Description}

Indicates whether this field is read-only.
Parameters:
Name Type Attributes Description
readOnly bool <optional>
When provided, this method acts as a setter and sets the isReadOnly value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored isReadOnly value; otherwise it returns 'this' for use with the builder pattern.
Type
bool | Description

isRequired(isRequiredopt) → {bool|Description}

Indicates whether this field is mandatory.
Parameters:
Name Type Attributes Description
isRequired bool <optional>
When provided, this method acts as a setter and sets the isRequired value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored isRequired value; otherwise it returns 'this' for use with the builder pattern.
Type
bool | Description

isVisible(visibleopt) → {bool|Description}

Indicates whether the object is visible.
Parameters:
Name Type Attributes Description
visible bool <optional>
When provided, this method acts as a setter and sets the isVisible value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored isVisible value; otherwise it returns 'this' for use with the builder pattern.
Type
bool | Description

location(locationopt) → {Point|Description}

The object's coordinates relative to the parent window (in pixels).
Parameters:
Name Type Attributes Description
location Point <optional>
When provided, this method acts as a setter and sets the location value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored location value; otherwise it returns 'this' for use with the builder pattern.
Type
Point | Description

max(maxValopt) → {number|Description}

The maximum value that can be entered in the field.
Parameters:
Name Type Attributes Description
maxVal number <optional>
When provided, this method acts as a setter and sets the max value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored max value; otherwise it returns 'this' for use with the builder pattern.
Type
number | Description

maxCharsInLine(valueopt) → {number|Description}

The maximum number of characters allowed per line in this edit field.
Parameters:
Name Type Attributes Description
value number <optional>
When provided, this method acts as a setter and sets the maxCharsInLine value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored maxCharsInLine value; otherwise it returns 'this' for use with the builder pattern.
Type
number | Description

maxLength(maxLengthopt) → {number|Description}

The maximum number of characters that can be entered in the input field.
Parameters:
Name Type Attributes Description
maxLength number <optional>
When provided, this method acts as a setter and sets the maxLength value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored maxLength value; otherwise it returns 'this' for use with the builder pattern.
Type
number | Description

min(minValopt) → {number|Description}

The minimum value that can be entered in the field.
Parameters:
Name Type Attributes Description
minVal number <optional>
When provided, this method acts as a setter and sets the min value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored min value; otherwise it returns 'this' for use with the builder pattern.
Type
number | Description

name(nameopt) → {string|Description}

The object's name property.
Parameters:
Name Type Attributes Description
name string <optional>
When provided, this method acts as a setter and sets the name value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored name value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

outerHTML(outerHTMLopt) → {string|Description}

The object's HTML code and its content.
Parameters:
Name Type Attributes Description
outerHTML string <optional>
When provided, this method acts as a setter and sets the outerHTML value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored outerHTML value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

outerText(outerTextopt) → {string|Description}

The object's text (supported in Internet Explorer only).
Parameters:
Name Type Attributes Description
outerText string <optional>
When provided, this method acts as a setter and sets the outerText value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored outerText value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

pattern(patternopt) → {string|Description}

The pattern in the edit field.
Parameters:
Name Type Attributes Description
pattern string <optional>
When provided, this method acts as a setter and sets the pattern value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored pattern value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

placeholder(placeholderopt) → {string|Description}

The hint text that is displayed in the edit box until a value is entered in it.
Parameters:
Name Type Attributes Description
placeholder string <optional>
When provided, this method acts as a setter and sets the placeholder value.
Returns:
If no parameter is provided, the method acts as a getter and returns the placeholder value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

role(roleValueopt) → {string|Description}

The defined role of this object. For example, if the role property is listbox, the object functions as a list box.
Parameters:
Name Type Attributes Description
roleValue string <optional>
When provided, this method acts as a setter and sets the role value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored role value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

rowsCount(rowsCountopt) → {number|Description}

The number of rows that can be entered in the input field.
Parameters:
Name Type Attributes Description
rowsCount number <optional>
When provided, this method acts as a setter and sets the rowsCount value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored rowsCount value; otherwise it returns 'this' for use with the builder pattern.
Type
number | Description

size(sizeopt) → {Size|Description}

The object's size (in pixels).
Parameters:
Name Type Attributes Description
size Size <optional>
When provided, this method acts as a setter and sets the size value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored size value; otherwise it returns 'this' for use with the builder pattern.
Type
Size | Description

styles(stylesopt) → {Object|Description}

The object's computed style.
Parameters:
Name Type Attributes Description
styles Object <optional>
When provided, this method acts as a setter and sets the object by its computed style value. * Specify the style names as object keys and set their values to the desired style values.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored styles object; otherwise it returns 'this' for use with the builder pattern.
Type
Object | Description

tagName(tagopt) → {string|Description}

The object's HTML tag.
Parameters:
Name Type Attributes Description
tag string <optional>
When provided, this method acts as a setter and sets the HTML tagName value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored HTML tagName value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

title(titleopt) → {string|Description}

The object's title.
Parameters:
Name Type Attributes Description
title string <optional>
When provided, this method acts as a setter and sets the title value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored title value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

type(typeopt) → {string|Description}

The type of object as defined in the HTML input tag.
Parameters:
Name Type Attributes Description
type string <optional>
When provided, this method acts as a setter and sets the type value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored type value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description

value(valueopt) → {number|Description}

The current text in this field.
Parameters:
Name Type Attributes Description
value number <optional>
When provided, this method acts as a setter and sets the value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored value; otherwise it returns 'this' for use with the builder pattern.
Type
number | Description

vri(valueopt, valueopt)

Sets a VisualRelation definition.
The VRI definition helps to distinguish this object from other objects with otherwise identical descriptions, based on this object's visual relationship to another object in the application.
Parameters:
Name Type Attributes Description
value Object <optional>
The object containing the VRI definition for this object.
Properties
Name Type Attributes Default Description
anchor Object The related test object.
horizontal Horizontal <optional>
The horizontal relation definition.
hInline bool <optional>
false The horizontal inline definition.
vertical Vertical <optional>
The vertical relation definition.
vInline string <optional>
false The vertical inline definition.
proximity Proximity <optional>
The proximity relation definition.
value Array <optional>
Array that contains multiple VRI definition for this object.

xpath(selectoropt) → {string|Description}

The path to this object in XPath format. For example: //TR[@id='LeanFT']/*\/INPUT
Parameters:
Name Type Attributes Description
selector string <optional>
When provided, this method acts as a setter and sets the xpath value.
Returns:
If no parameter is provided, the method acts as a getter and returns the current stored xpath value; otherwise it returns 'this' for use with the builder pattern.
Type
string | Description