Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

The Amazon SDK for JavaScript V3 API Reference Guide describes in detail all the API operations for the Amazon SDK for JavaScript version 3 (V3).

Node.js considerations

Although Node.js code is JavaScript, using the Amazon SDK for JavaScript in Node.js can differ from using the SDK in browser scripts. Some API methods work in Node.js but not in browser scripts, as well as the other way around. And successfully using some APIs depends on your familiarity with common Node.js coding patterns, such as importing and using other Node.js modules like the File System (fs) module.

Use built-in Node.js modules

Node.js provides a collection of built-in modules you can use without installing them. To use these modules, create an object with the require method to specify the module name. For example, to include the built-in HTTP module, use the following.

import http from 'http';

Invoke methods of the module as if they are methods of that object. For example, here is code that reads an HTML file.

// include File System module
import fs from "fs"; 
// Invoke readFile method 
fs.readFile('index.html', function(err, data) {
  if (err) {
    throw err;
  } else {
    // Successful file read
  }
});

For a complete list of all built-in modules that Node.js provides, see Node.js documentation on the Node.js website.

Use npm packages

In addition to the built-in modules, you can also include and incorporate third-party code from npm, the Node.js package manager. This is a repository of open source Node.js packages and a command-line interface for installing those packages. For more information about npm and a list of currently available packages, see https://www.npmjs.com. You can also learn about additional Node.js packages you can use here on GitHub.