ANS-0881 · SUITESCRIPT DEVELOPMENT
Does nlapiYieldScript Function Reliably with Try/Catch Blocks in SuiteScript 1.0?
When using nlapiYieldScript in SuiteScript 1.0, errors within try...catch blocks can prevent proper script rescheduling due to serialization failures.
Short answer
No, nlapiYieldScript in SuiteScript 1.0 may fail to reschedule if an error is thrown within a try...catch block, often due to an inability to serialize the nlobjError object. For reliable error handling and yielding, it is recommended to avoid nlapiYieldScript and implement standard rescheduling mechanisms, or transition to SuiteScript 2.x's Map/Reduce scripts or N/task module.
Scenario
Developers utilizing nlapiYieldScript within SuiteScript 1.0 scheduled scripts may encounter issues when attempting to handle errors using try...catch blocks. Specifically, if an error is thrown during script execution, nlapiYieldScript can fail to reschedule the script, resulting in an 'UNEXPECTED ERROR: Failed to Serialized Scheduled Script: nlobjError' message. This occurs because the script is unable to properly serialize the error object for rescheduling.
Solution
To address the unreliability of nlapiYieldScript with try...catch blocks in SuiteScript 1.0, particularly concerning error serialization during rescheduling, the recommended solution is to avoid using nlapiYieldScript. Instead, developers should implement standard script rescheduling practices.For SuiteScript 1.0, this means:
Manually check script governance usage.
If governance limits are approached, explicitly reschedule the script using nlapiScheduleScript to ensure proper continuation without relying on nlapiYieldScript's yielding mechanism, which can be problematic with errors.For current NetSuite development, it is strongly advised to transition to SuiteScript 2.x, which offers more robust and reliable methods for handling large datasets and script yielding:
Map/Reduce Script Type
This script type is specifically designed for processing large data volumes, automatically managing yielding and rescheduling across its distinct stages.
N/task Module
For more granular control over script execution and rescheduling, the N/task module provides functions to create and submit scheduled script tasks, allowing for explicit control over script continuation and error management.These SuiteScript 2.x approaches provide a more stable environment for error handling with try...catch blocks, mitigating the serialization issues associated with nlapiYieldScript.
Expert NetSuite Support
Need help with this NetSuite issue?
SuiteScript Development consulting and configuration support