Differences Between SuiteScript 2.0 and SuiteScript 2.1

You use extends in one of the following ways in a script:

                      myObj({extends: 'test'});
function myFunction(extends) {}
function extends() {}
var extends = 1; 

                    

The script executes and does not generate an error. The extends identifier is not a reserved word in ECMAScript 5.1.

The script generates a syntax error. The extends identifier is a reserved word in ECMAScript 2023.

You use the following code to create an Error object with no argument in a script:

                      var myFirstError = new Error();
myFirstError.message = 'A message';

var firstErrorJson = JSON.stringify(myFirstError); 

                    

The firstErrorJson variable contains the following output:

                      {
    'message' : 'A message'
} 

                    

The firstErrorJson variable contains the following output:

                      {
    'message' : 'A message'
} 

                    

You use the following code to create an Error object with an argument in a script:

                      var mySecondError = new Error('');
mySecondError.message = 'A message';

var secondErrorJson = JSON.stringify(mySecondError); 

                    

The secondErrorJson variable contains the following output:

                      {
    'message' : 'A message'
} 

                    

The secondErrorJson variable contains the following output:

                      {} 

                    

You try to parse the following JSON string in a script:

                      var obj = 'b';
JSON.parse(obj); 

                    

The following error is generated:

org.mozilla.javascript.EcmaError: SyntaxError: Unexpected token: b

The following (or similar) error is generated:

SyntaxError: Invalid JSON: <json>:1:0 Expected json literal but found b

You try to parse the following JSON string in a script:

                      JSON.parse('{"mykey" : 1, }'); 

                    

The script executes successfully.

The following (or similar) error is generated:

SyntaxError: Invalid JSON: <json>:1:0 Expected json literal but found ,

You place a portion of your script (or your entire script) into strict mode and assign a value to an undeclared variable:

                      'use strict';
x = 122;
log.debug('x = ', x); 

                    

Script execution completes without throwing an error.

The following error is generated:

ReferenceError: x is not defined

You set a value for a const variable and then try to assign it a new value:

                      const recordId = 1;
recordId = 2;
log.debug("recordId", recordId); 

                    

The script completes execution successfully, however the value of recordId is not changed by the recordId =2; line. The log statement will write: recordId 1.

The execution stops at the recordId =2; line, and the following error is generated:

TypeError: Assignment to constant variable

You use a for...each...in statement to process values in an object:

                      var obj = {fileType: "csv", encoding: "UTF-8", isOnline: "false"};
for each(var value in obj) {
    log.debug("value = " , value);
} 

                    

The for...each...in statement is accepted and allows you to process the values in the object.

The following error is generated:

SyntaxError: SyntaxError: <eval>:3:4 Expected ( but found each for each ( var value in obj) {

You create a date and log two different formats for that date:

                      var event = new Date(Date.UTC(2012, 12, 21, 12));
log.debug("date1 = ", event.toLocalDateString();
log.debug("date2 = ", event.toLocalDateString('de-De', { year: 'numeric', month: 'long', day: 'numeric' })); 

                    

The default format is the long format, and additional properties passed are ignored.

The output is:

• date1 =December 21, 2012

• date2 =December 21, 2012

The default format is the short format, and additional properties passed are ignored.

The output is:

• date1 = 2012–12–21

• date2 = 2012–12–21

You create a try-catch statement with an if statement in the catch block:

                      try {
// do something here
} catch (e if e instanceof TypeError) { // Don't use
    log.debug("error = " , e);
} 

                    

The script completes execution without throwing an error.

The following error is generated:

SyntaxError: SyntaxError: <eval>:2:11 Expected ) but found if } catch (e if e instanceof TypeError) { // Don’t use

You try to log a transactions source:

                      function Transaction(name) {
    this.name = name;
}
var obj = new Transaction("myTrans");
log.debug("Transaction = ", Transaction.toSource());
log.debug("Transaction Obj = ", obj.toSource()); 

                    

The script completes execution without throwing an error.

An error is thrown indicating toSource is not a valid function.

You set a decimal value with trailing zeros:

                      record.setValue('memo', 616.00) 

                    

record.setValue() saves a number as a double number: 616.0.

record.setValue() saves a number with trailing zeros as an Integer: 616.

You set a decimal value with no trailing zeros:

                      record.setValue('memo', 616.01) 

                    

record.setValue() saves a number as a double number: 616.01.

record.setValue() saves a number as a double number: 616.01.

You return JSON.stringify in a post function:

                      // the following is included in a 2.x RESTlet
...
function post() {
    return JSON.stringify("flower");
} 

                    

Returns "\"flower\"" and a string length of 12.

If you specify "flower" in the return statement, "flower" is returned with a string length of 8.

Returns "flower" and a string length of 8.

If you specify "flower" in the return statement, flower is returned with a string length of 6.

                      let xmlRequest = new XMLHttpRequest();
var url = "/app/site/hosting/restlet.nl?script=RESTLET_SCRIPT_ID&deploy=RESTLET_DEPLOYMENT_ID";

xmlRequest.onreadystatechange = () => {
    if (xmlRequest.readyState === 4) {
        if (xmlRequest.status === 200) {
            log.debug("xmlRequest.responseText=" + xmlRequest.responseText);
            log.debug("xmlRequest.responseText.length=" + xmlRequest.responseText.length);
        } else {
            log.debug("xmlRequest.status=" + xmlRequest.responseText);
        }
    }
};

xmlRequest.open("POST", url, true /* async */);
xmlRequest.setRequestHeader("Content-Type", "application/json");
xmlRequest.send(JSON.stringify({})); // log statements appear after request is sent 

                    

The log statements are:

xmlRequest.responseText="\"ok\""

xmlRequest.responseText.length=8

The log statements are:

xmlRequest.responseText="ok"

xmlRequest.responseText.length=4

You set the Content-Type in a RESTlet header to application/json. For example, see the following sample RESTlet script and sample code for calling the RESTlet.

                      /**
 /**
 * @NApiVersion 2.x
 * @NScriptType restlet
 */
define([], function() {
        function get() {
                var x = {name:"jane", age:20};
                return JSON.stringify(x);
        }
        return {
                get: get
        }
}); 

                    

                      var host = window.location.host;
var url = 'https://' + host + '/app/site/hosting/restlet.nl?script=customscript296&deploy=customdeploy1';
var xhttp = new XMLHttpRequest();
xhttp.onreadystatechange = function() {
    if (this.readyState == 4 && this.status == 200) {
       alert(typeof xhttp.response);
 alert(typeof JSON.parse(xhttp.response));
    }
};
xhttp.open("GET", url, true);
xhttp.setRequestHeader('Content-Type', 'application/json');
xhttp.send(); 

                    

The response is automatically converted to a string and that string is returned instead of an object.

In the example scenario, the alert output is a string, SS2.0 gives string; but in SS2.1 it comes as object.

The return type for JSON will be an object.

In the example scenario, the alert output is an object.

Parse a string value representing a number.

                      require([],function() { 
    var x = parseInt('08');
    log.debug('x', x); 
}); 

                    

There is no value assigned to x.

The return value for x is 8.