The JS.getValueJson function returns the JSON representation of a JavaScript variable or property by calling the JSON.stringify method. This is a useful way to transfer data from JavaScript to CSPro logic if the data cannot be represented by a CSPro object that can be handled by the JS.getValue function.

The string expression name is evaluated and can refer to a variable in CSPro's JavaScript global execution context or an object's property if the object exists globally. For example, the following values can be specified as a name:

The function returns a string containing the JSON if the variable or property is defined. If undefined, or if the JavaScript evaluation ends in an uncaught exception, the function returns a blank string and displays an error message. If you do not want to see the error message, check the existence of the variable or property by using the JS.hasValue function.

See also: JavaScript Use in CSPro, JS Namespace, JS.getValue Function, JS.hasValue Function, JS.setValueFromJson Function