Help us improve the AWS SDK for JavaScript version 3 (V3) documentation by providing feedback using the Feedback link, or create an issue or pull request on GitHub.

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).

Migrating your code to SDK for JavaScript V3

There are a number of migration paths to the SDK for JavaScript version 3 (V3). To take full advantage of the reduction in capacity potential of V3, we recommend using path 3.

Path 1

Perform minimal changes:

• Install only the specific AWS Service packages you need.

• Create and use V3 service clients, replacing the use of any global configuration values, such as Region, with configuration values passed in as arguments to the client.

  Note

  You can set the AWS Region using an environment variable, or a shared configuration config file. For more information, see Setting credentials in Node.js.

Path 2

Follow path 1 and remove .promise, which are not required in V3.

Path 3

Follow path 1 and use the async/await programming model.

The following sections describe these paths in detail, with examples.

Path 1 example

The following code installs the AWS Service package for Amazon S3.

npm install @aws-sdk/client-s3

The following code loads the Amazon S3 service.

import {S3} from '@aws-sdk/client-s3';

The following code creates an Amazon S3 service object in the us-west-2 Region.

const client = new S3({region: 'us-west-2'});

The following code creates and Amazon S3 bucket using a callback function, using the following syntax from V2.

client.command(parameters)

import {S3} from '@aws-sdk/client-s3';
const client = new S3({region: 'us-west-2'});
const bucketParams = {
    Bucket : BUCKET_NAME
};
function run(){
         client.createBucket(bucketParams, function(err, data) {
         if (err) {
         console.log("Error", err);
         } else {
         console.log("Success", data.Location);
         }
    })
};
run();

Path 2 example

Here is a function call in V2 using a promise.

const data =  await v2client.command(params).promise()

Here is the V3 version.

const data = await v3client.command(params)

Path 3 examples

The following command installs the AWS Service package for Amazon S3.

npm install @aws-sdk/client-s3; 

The following code loads only the Amazon S3 client, reducing the overhead.

import {S3Client, CreateBucketCommand} from '@aws-sdk/client-s3';

If you install only the client of a package, you must also import the V3 commands you want to use. In this case, the code imports the CreateBucketCommand, which enables you to create an Amazon S3 bucket. You can browse the available commands in your project's node-modules/@aws-sdk/client-PACKAGE_NAME/commands folder.

The following code creates an Amazon S3 service client object in the us-west-2 Region.

const client = new S3Client({region: 'us-west-2'});

To call imported commands using the recommended async/await pattern, you must import the commands you want to use, and use the following syntax to run the command.

  CLIENT.send(newXXXCommand)

The following example creates an Amazon S3 bucket using the async/await pattern, using only the client of the Amazon S3 service package to reduce overhead.

import {S3Client, CreateBucketCommand} from '@aws-sdk/client-s3';
const client = new S3Client({region: 'us-west-2'});
const bucketParams = {
    Bucket : BUCKET_NAME
};

(async function () {
      try{
        const data = await client.send(new CreateBucketCommand(bucketParams));
        console.log("Success", data);
      } catch (err) {
        console.log("Error", err);
      }
})(); 

For more examples, see SDK for JavaScript code examples.