UFT Web Add-in Extensibility API Reference
toSafeArray Method
Converts a JavaScript Array object to a COM SafeArray.

Remarks

Some UFT utility methods, such as Record and Report, require SafeArray type arguments.

Syntax

JScript 
public function toSafeArray(
    inArray : Array
);

Parameters

inArray
A JavaScript Array.

Returns

A SafeArray with the elements of the input array in the same order.

Example

In the following example, an array is created, and then converted to a SafeArray.

	var arr = new Array();

	// Add objects to the array.
	arr[0] = "item1";
	arr[1] = "item2";
	arr[4] = "item3";

	// Return a COM array with the following items:
	//  { "item1", "item2", null, null, "item3" }
	return toSafeArray(arr);
	

See Also