AWS SDK for JavaScript in the browser and Node.js
JavaScript CoffeeScript Gherkin Ruby HTML CSS TypeScript
Latest commit 1c6135e Mar 28, 2017 awstools Updates SDK to v2.34.0
Permalink
Failed to load latest commit information.
.changes Updates SDK to v2.34.0 Mar 28, 2017
apis Updates SDK to v2.34.0 Mar 28, 2017
clients Updates SDK to v2.34.0 Mar 28, 2017
dist-tools Use HTTP status code as error code if provided body cannot be parsed. ( Mar 10, 2017
dist Updates SDK to v2.34.0 Mar 28, 2017
doc-src/templates Remove unused developer guide Mar 1, 2017
features Updates smoke tests to work with temporary credentials (#1421) Mar 22, 2017
lib Updates SDK to v2.34.0 Mar 28, 2017
scripts Generate the list of services supported by the SDK to a separate file. Mar 1, 2017
tasks Run browser tests via Karma instead of custom phantomjs runner (#1352) Feb 10, 2017
test Ensure MultipartUpload locations returned by the managed uploader are… Mar 27, 2017
ts Add a means of specifying tags for s3.upload that applies to both sin… Mar 23, 2017
.eslintrc Update linter rules Jun 16, 2015
.gitignore Add istanbul for coverage and improve some test coverage Jun 16, 2014
.jshintrc Remove JSHint options CC doesn't understand Oct 2, 2014
.npmignore Bundles TypeScript definition files and adds generation of d.ts files… Nov 10, 2016
.tesselinclude Adds .tesselinclude for resource deployment inclusion. Fixes gh-967 Apr 18, 2016
.travis.yml Replace coveralls with codecov Mar 10, 2017
.yardopts Add upgrading notes (1.x-2.0) to repository Jun 10, 2014
.yardopts_guide Add UPGRADING.md to guide Jun 13, 2014
CHANGELOG.md Updates SDK to v2.34.0 Mar 28, 2017
CONTRIBUTING.md Replace usages of "npm run-script" in contributing.md to juse "npm run" Jan 30, 2017
Gemfile Update navigation bar in template Jul 8, 2015
Gemfile.lock Update navigation bar in template Jul 8, 2015
LICENSE.txt Update copyright years throughout Jan 31, 2017
NOTICE.txt Update copyright years throughout Jan 31, 2017
README.md Updates SDK to v2.34.0 Mar 28, 2017
Rakefile Don't need bundle/setup in Rakefile Mar 14, 2014
SERVICES.md Generate the list of services supported by the SDK to a separate file. Mar 1, 2017
UPGRADING.md Update upgrading notes to mention removed `.client` property. Jun 20, 2014
bower.json Update bower.json Jul 7, 2015
browser.js Updates node and browser loaders Sep 8, 2016
codecov.yml Ensure codecov runs after any job completes Mar 21, 2017
configuration.sample Add support for AWS.DeviceFarm Jul 14, 2015
global.d.ts Bundles TypeScript definition files and adds generation of d.ts files… Nov 10, 2016
global.js Updates node and browser loaders Sep 8, 2016
index.d.ts Bundles TypeScript definition files and adds generation of d.ts files… Nov 10, 2016
index.js Add index.js for convenience Jul 8, 2014
karma.conf.js Run browser tests via Karma instead of custom phantomjs runner (#1352) Feb 10, 2017
package.json Updates SDK to v2.34.0 Mar 28, 2017
testem.json Update testem.json Aug 26, 2014

README.md

AWS SDK for JavaScript

NPM

Gitter chat

Version Build Status Coverage Status

The official AWS SDK for JavaScript, available for browsers and mobile devices, or Node.js backends

For release notes, see the CHANGELOG. Prior to v2.4.8, release notes can be found at http://aws.amazon.com/releasenotes/SDK/JavaScript

If you are upgrading from 1.x to 2.0 of the SDK, please see the {file:UPGRADING.md} notes for information on how to migrate existing code to work with the new major version.

Installing

In the Browser

To use the SDK in the browser, simply add the following script tag to your HTML pages:

<script src="https://sdk.amazonaws.com/js/aws-sdk-2.34.0.min.js"></script>

You can also build a custom browser SDK with your specified set of AWS services. This can allow you to reduce the SDK's size, specify different API versions of services, or use AWS services that don't currently support CORS if you are working in an environment that does not enforce CORS. To get started:

http://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/building-sdk-for-browsers.html

The AWS SDK is also compatible with browserify.

In Node.js

The preferred way to install the AWS SDK for Node.js is to use the npm package manager for Node.js. Simply type the following into a terminal window:

npm install aws-sdk

Using Bower

You can also use Bower to install the SDK by typing the following into a terminal window:

bower install aws-sdk-js

Usage and Getting Started

You can find a getting started guide at:

http://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide

Usage with TypeScript

The AWS SDK for JavaScript bundles TypeScript definition files for use in TypeScript projects and to support tools that can read .d.ts files. Our goal is to keep these TypeScript definition files updated with each release for any public api.

Pre-requisites

Before you can begin using these TypeScript definitions with your project, you need to make sure your project meets a few of these requirements:

  • Use TypeScript v2.x
  • Includes the TypeScript definitions for node. You can use npm to install this by typing the following into a terminal window:
  npm install --save-dev @types/node
  • Your tsconfig.json or jsconfig.json includes 'dom' and 'es2015.promise' under compilerOptions.lib. See tsconfig.json for an example.

In the Browser

To use the TypeScript definition files with the global AWS object in a front-end project, add the following line to the top of your JavaScript file:

/// <reference types="aws-sdk" />

This will provide support for the global AWS object.

In Node.js

To use the TypeScript definition files within a Node.js project, simply import aws-sdk as you normally would. In a TypeScript file:

// import entire SDK
import AWS = require('aws-sdk');
// import AWS object without services
import AWS = require('aws-sdk/global');
// import individual service
import S3 = require('aws-sdk/clients/s3');

In a JavaScript file:

// import entire SDK
var AWS = require('aws-sdk');
// import AWS object without services
var AWS = require('aws-sdk/global');
// import individual service
var S3 = require('aws-sdk/clients/s3');

Known Limitations

There are a few known limitations with the bundled TypeScript definitions at this time:

  • Service client typings reflect the latest apiVersion, regardless of which apiVersion is specified when creating a client.
  • Service-bound parameters use the any type.

Getting Help

Please use these community resources for getting help. We use the GitHub issues for tracking bugs and feature requests and have limited bandwidth to address them.

  • Ask a question on StackOverflow and tag it with aws-sdk-js
  • Come join the AWS JavaScript community on gitter
  • Open a support ticket with AWS Support
  • If it turns out that you may have found a bug, please open an issue

Opening Issues

If you encounter a bug with the AWS SDK for JavaScript we would like to hear about it. Search the existing issues and try to make sure your problem doesn’t already exist before opening a new issue. It’s helpful if you include the version of the SDK, Node.js or browser environment and OS you’re using. Please include a stack trace and reduced repro case when appropriate, too.

The GitHub issues are intended for bug reports and feature requests. For help and questions with using the AWS SDK for JavaScript please make use of the resources listed in the Getting Help section. There are limited resources available for handling issues and by keeping the list of open issues lean we can respond in a timely manner.

Supported Services

Please see SERVICES.md for a list of supported services.

License

This SDK is distributed under the Apache License, Version 2.0, see LICENSE.txt and NOTICE.txt for more information.