The AWS SDK for JavaScript V3 API Reference Guide describes in detail all the API operations for the AWS SDK for JavaScript version 3 (V3).
Use JavaScript promises
Use the service client's AWS SDK for JavaScript v3 method ( ListTablesCommand
)to make
the service call and manage asynchronous flow instead of using callbacks. The following
example shows how to get the names of your Amazon DynamoDB tables in us-west-2
.
import {
DynamoDBClient,
ListTablesCommand
} from "@aws-sdk/client-dynamodb";
const dbClient = new DynamoDBClient({ region: 'us-west-2' });
dbClient.listtables(new ListTablesCommand({}))
.then(response => {
console.log(response.TableNames.join('\n'));
})
.catch((error) => {
console.error(error);
});
Coordinate multiple promises
In some situations, your code must make multiple asynchronous calls that require
action only when they have all returned successfully. If you manage those individual
asynchronous method calls with promises, you can create an additional promise that uses
the all
method.
This method fulfills this umbrella promise if and when the array of promises that you
pass into the method are fulfilled. The callback function is passed an array of the values
of the promises passed to the all
method.
In the following example, an AWS Lambda function must make three asynchronous calls to Amazon DynamoDB but can only complete after the promises for each call are fulfilled.
const values = await Promise.all([firstPromise, secondPromise, thirdPromise]);
console.log("Value 0 is " + values[0].toString);
console.log("Value 1 is " + values[1].toString);
console.log("Value 2 is " + values[2].toString);
return values;
Browser and Node.js support for
promises
Support for native JavaScript promises (ECMAScript 2015) depends on the JavaScript
engine and version in which your code executes. To help determine the support for
JavaScript promises in each environment where your code needs to run, see the ECMAScript compatibility table