

 [AWS SDK for JavaScript V3 API リファレンスガイド](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)では、 AWS SDK for JavaScript バージョン3 (V3) のすべての API オペレーションについて詳しく説明します。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS SDK for JavaScriptは何ですか。
<a name="welcome"></a>

AWS SDK for JavaScript デベロッパーガイドへようこそ。このガイドは、AWS SDK for JavaScriptのセットアップおよび設定に関する一般的な情報を提供します。AWS SDK for JavaScriptを使用してさまざまなAWSのサービスを実行する例やチュートリアルも紹介されています。

[AWS SDK for JavaScript v3 API Reference Guide](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)はAWS のサービスのJavaScript APIを提供します。JavaScript API を使用して、[Node.js](https://nodejs.org/en/) またはブラウザ用のライブラリまたはアプリケーションを構築できます。

![\[JavaScript 環境、SDK、およびアマゾン ウェブ サービスの関係\]](http://docs.aws.amazon.com/ja_jp/sdk-for-javascript/v3/developer-guide/images/sdk-overview-v3.png)


## SDK の使用を開始する
<a name="get-started-with-the-jssdkv3"></a>

SDK を実際に使用する準備ができている場合は、[AWS SDK for JavaScript の使用を開始する](getting-started.md) の例に従ってください。

開発環境を設定するには、「[SDK for JavaScript のセットアップ](setting-up.md)」を参照してください。

現在 SDK for JavaScript のバージョン 2.x を使用している場合、具体的なガイダンスについては、「[v3に移行する](migrating.md)」を参照してください。

AWS のサービスのコード例については、「[SDK for JavaScript (v3) のコード例](javascript_code_examples.md)」を参照してください。

## SDK メジャーバージョンのメンテナンスとサポート
<a name="sdks-major-versions-maintenance-support"></a>

SDK メジャーバージョンのメンテナンスとサポート、およびその基礎的な依存関係については、[AWS SDK とツール共有設定および認証情報リファレンスガイド](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) で以下を参照してください。
+ [AWS SDK とツールのメンテナンスポリシー](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html)
+ [AWS SDK とツールのバージョンサポートマトリクス](https://docs.aws.amazon.com/sdkref/latest/guide/version-support-matrix.html)

## Node.js で SDK を使用する
<a name="welcome_node"></a>

Node.js は、サーバー側の JavaScript アプリケーションを実行するための、クロスプラットフォームランタイムです。Node.js を Amazon Elastic Compute Cloud （Amazon EC2 ）インスタンスで設定してサーバーで実行できます。Node.js を使用してオンデマンドの AWS Lambda 関数を書き込むこともできます。

Node.js での SDK の使用方法は、ウェブブラウザの JavaScript で使用する方法とは異なります。この違いは、SDK のロード方法と、特定のウェブサービスにアクセスするために必要な認証情報の取得方法によるものです。特定の API の使用がNode.jsとブラウザの間で異なる場合、これらの違いを呼び出します。

## AWS Amplify による SDK の使用
<a name="welcome_amplify"></a>

ブラウザベースの Web、モバイル、ハイブリッドアプリケーションの場合は、 [AWS Amplify library on GitHub](https://github.com/aws/aws-amplify) を使用することもできます。JavaScript 用の SDK を拡張し、宣言タイプインターフェイスを提供します。

**注記**  
 Amplify などのフレームワークは、SDK for JavaScript と同じブラウザをサポートしない可能性があります。詳細については、フレームワークドキュメントを参照してください。

## ウェブブラウザで SDK を使用します。
<a name="welcome_web"></a>

主要なウェブブラウザはすべて JavaScript の実行をサポートしています。ウェブブラウザで実行されている JavaScript コードは、*クライアント側の JavaScript* と呼ばれます。

AWS SDK for JavaScript がサポートしているブラウザのリストについては、「[サポートされているウェブブラウザ](setting-up.md#browsers-supported)」を参照してください。

ウェブブラウザでの SDK for JavaScript の使用方法は、Node.js を使用する方法とは異なります。この違いは、SDK のロード方法と、特定のウェブサービスにアクセスするために必要な認証情報の取得方法によるものです。特定の API の使用がNode.jsとブラウザの間で異なる場合、これらの違いを呼び出します。

### V3 でブラウザーを使用
<a name="v3_browsers"></a>

V3 を使用すると、必要なSDK for JavaScript ファイルのみをブラウザにバンドルして含めることができ、オーバーヘッドを削減できます。

SDK for JavaScriptのV3をHTMLページで使用するには、必要なクライアントモジュールと必要なすべてのJavaScript関数をWebpackを使用して単一のJavaScriptファイルにバンドルし、`<head>`HTMLページのスクリプトタグに追加する必要があります。例えば、

```
<script src="./main.js"></script>
```

**注記**  
Webpackの詳細については、[Webpack でアプリケーションをバンドルする](webpack.md)を参照してください。

SDK for JavaScript の V2 を使用するには、代わりに V2 SDK の最新バージョンを指すスクリプトタグを追加します。詳細については、「AWS SDK for JavaScript デベロッパーガイド v2」の「[サンプル](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/getting-started-browser.html#getting-started-browser-write-sample)」を参照してください。

### 一般的なユースケース
<a name="welcome_use_cases"></a>

ブラウザスクリプトで SDK for JavaScript を使用すると、多くの魅力的なユースケースを実現できます。SDK for JavaScript を使用してさまざまなウェブサービスにアクセスすることにより、ブラウザーアプリケーションで構築できるいくつかのアイデアを次に示します。
+ AWS のサービス用にカスタムコンソールを構築して、複数のリージョンやサービスにわたる機能にアクセスし、それらを組み合わせて組織やプロジェクトのニーズが最大限に満たされるようにします。
+ Amazon Cognito アイデンティティを使用して、Facebook やその他のサードパーティーによる認証の使用を含めて、認証されたユーザーがブラウザアプリケーションやウェブサイトにアクセスできるようにします。
+ Amazon Kinesis を使用して、クリックストリームやその他のマーケティングデータをリアルタイムで処理します。
+ ウェブサイトの訪問者やアプリケーションユーザー向けの個別の優先ユーザー選定などの、サーバーレスデータの永続性のために Amazon DynamoDB を使用します。
+ AWS Lambda を使用して、ダウンロードなしで、知的財産をユーザーに公開することなくブラウザのスクリプトから呼び出すことができる独自のロジックをカプセル化する。

### 例について
<a name="welcome_examples"></a>

[AWSCode Example Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code)でSKD for JavaScriptの例を参照できます。

### リソース
<a name="welcome_resources"></a>

このガイドに加えて、SDK for JavaScriptデベロッパーには次のオンラインリソースが利用可能です。
+ [AWS SDK for JavaScript[V3 API Reference Guide](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) ]
+  「[AWS SDK とツールのリファレンスガイド](https://docs.aws.amazon.com/sdkref/latest/guide/)」: AWS SDK に共通する設定、機能、その他の基本概念が記載されています。
+ [JavaScript Developer Blog](https://aws.amazon.com/blogs/developer/category/programing-language/javascript/)
+ [AWS re:Post](https://repost.aws/en/search/content?globalSearch=aws-sdk-js)
+ [AWS コードライブラリの JavaScript の例](https://docs.aws.amazon.com/code-library/latest/ug/javascript_3_code_examples.html)
+ [AWS[Code Example Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code) ]
+ [Gitter チャネル](https://gitter.im/aws/aws-sdk-js)
+ [スタックオーバーフロー](https://stackoverflow.com/search?tab=newest&q=aws-sdk-js)
+ [Stack Overflow questions taggedAWS -sdk-js](https://stackoverflow.com/questions/tagged/aws-sdk-js?sort=newest)
+ GitHub
  + [SDK Source](https://github.com/aws/aws-sdk-js-v3/)
  + [Documentation Source](https://github.com/awsdocs/aws-sdk-for-javascript-v3)