All Products
Search
Document Center

Tablestore:Node.js SDK error handling

Last Updated:Aug 04, 2026

The Tablestore Node.js SDK handles errors by throwing exceptions. This topic describes the error handling methods, exception information, and retry policies for the SDK.

Method

The Tablestore Node.js SDK handles errors by throwing exceptions. If an API call does not throw an exception, the operation is successful. Otherwise, the operation has failed.

Note

For batch operations, such as BatchGetRow and BatchWriteRow, you must check for exceptions and verify the status of each row. The API call is considered successful only if all rows are processed successfully.

Exceptions

All errors in the Tablestore Node.js SDK are handled uniformly. The errors are returned in the err parameter of the callback method. Before you retrieve the returned data, you must check whether the err parameter has a value.

If a server-side error occurs, Tablestore returns a requestId. The requestId is a universally unique identifier (UUID) for the request. If you cannot resolve the issue, record this requestId and submit a ticket.

Retries

The SDK automatically retries an operation if an error occurs. The default policy allows up to 20 retries with a maximum retry interval of 3000 ms. Retries are performed for throttling errors and server-side internal errors related to read operations. For more information, see tablestore/lib/retry.