Connection.list Method Parameters Update in NetSuite 2026.1

The Connection.list method is an essential part of the N/sftp module, allowing users to list remote directories effectively. Starting in NetSuite 2026.1, there have been updates to the parameters used in this method, enhancing the functionality and flexibility of file management.

Overview of Connection.list

This method returns an array of Objects, each containing properties relevant to files and directories within the specified path, including:

• directory: A boolean flag indicating whether the entry is a directory (true) or a file (false).
• name: The name of the file or directory.
• size: The size of the file.
• lastModified: The date the file was last modified.

Updated Parameters

The options parameter is a JavaScript object with the following required fields:

Error Handling

When using the Connection.list method, it is essential to handle potential errors:

• FTP_INVALID_DIRECTORY: This error occurs if the specified directory does not exist on the remote FTP server.
• FTP_PERMISSION_DENIED: This indicates that access to the specified file or directory has been denied.

Example Syntax

The following code sample illustrates how to utilize the Connection.list method:

let objConnection = connection.list({
    path: 'yyy/test',
    sort: 'name'
});

Key Improvements

This update not only strengthens the capability of listing remote directories but also ensures that developers can more efficiently manage file transfers within their SuiteScripts.

Who This Affects

The updates to the Connection.list parameters will particularly benefit:

• SuiteScript Developers
• System Administrators managing SFTP integrations
• Anyone working with remote file systems in NetSuite

Key Takeaways

• The Connection.list method now supports enhanced parameters for better file management.
• Error handling has been clarified for improved robustness.
• SuiteScript developers will find these updates beneficial for their coding tasks in NetSuite.