SDK for JavaScript のセットアップ - AWS SDK for JavaScript

AWS SDK for JavaScript V3 API リファレンスガイドでは、AWS SDK for JavaScript バージョン3 (V3) のすべての API オペレーションについて詳しく説明します。

SDK for JavaScript のセットアップ

このセクションのトピックでは、SDK for JavaScript をインストールおよびロードし、SDK がサポートするウェブサービスにアクセスする方法について説明します。

前提条件

Node.js をインストールします。AWS では、開発にアクティブ LTS バージョンの Node.js を使用することをお勧めします。

AWS Node.js 環境をセットアップする

アプリケーションを実行可能な AWS Node.js 環境を設定するには、次のいずれかの方法を使用します。

  • Node.js がプリインストールされている Amazon マシンイメージ (AMI) を選択します。次に、その AMI を使用してAmazon EC2 インスタンスを作成します。Amazon EC2 インスタンスを作成するときは、AWS Marketplace から AMI を選択してください。AWS Marketplaceで Node.js を検索し、Node.jsのプリインストールバージョン (32 ビットまたは 64 ビット) を含む AMI オプションを選択します。

  • Amazon EC2 インスタンスを作成して、Node.js をインストールします。Amazon Linux インスタンスで Node.js をインストールする方法の詳細については、Amazon EC2 インスタンスでの Node.js を設定するを参照してください。

  • AWS Lambdaを使用して、Node.js を Lambda 関数として実行し、サーバーレス環境を作成します。Lambda 関数内で Node.js を使用する方法の詳細は、[ AWS Lambda Developer Guide][ Programming model (Node.js) ]を参照してください。

  • Node.js アプリケーションをAWS Elastic Beanstalk にデプロイします。Elastic Beanstalk で Node.js を使用する方法の詳細については、AWS Elastic Beanstalk[Developer Guide ][ Deploying Node.js applications to AWS Elastic Beanstalk ]を参照してください。

  • AWS OpsWorksを使用して、Node.js アプリケーションサーバーを作成します。OpsWorksで Node.js を使用する方法の詳細については、 [ AWS OpsWorks User Guide ][ Creating your first Node.js stack ]を参照してください。

サポートされているウェブブラウザ

AWS SDK for JavaScript は、最新のすべてのウェブブラウザをサポートしています。

バージョン 3.567.0 以降の SDK for JavaScript は ES2021 アーティファクトを出力します。このアーティファクトは、以下の最小バージョンをサポートしています。

ブラウザ バージョン
Google Chrome 85.0 以降
Mozilla Firefox 80.0 以降
Opera 71.0 以降
Microsoft Edge 85.0 以降
Apple Safari 14.1 以降
サムスン・インターネット 14.0 以降

バージョン 3.183.0~3.566.0 の SDK for JavaScript は ES2020 アーティファクトを使用します。このアーティファクトは、以下の最小バージョンをサポートしています。

ブラウザ バージョン
Google Chrome 80.0 以降
Mozilla Firefox 80.0 以降
Opera 63.0 以降
Microsoft Edge 80.0 以降
Apple Safari 14.1 以降
サムスン・インターネット 12.0 以降

バージョン 3.182.0 以前は、SDK for JavaScript は ES5 アーティファクトを使用します。このアーティファクトは、以下の最小バージョンをサポートしています。

ブラウザ バージョン
Google Chrome 49.0 以降
Mozilla Firefox 45.0 以降
Opera 36.0 以降
Microsoft Edge 12.0 以降
Windows Internet Explorer 該当なし
Apple Safari 9.0 以降
Android ブラウザ 76.0 以降
UC ブラウザ 12.12 以降
サムスン・インターネット 5.0 以降
注記

AWS Amplifyなどのフレームワークは、SDK for JavaScript と同じブラウザサポートを提供しない場合があります。詳細については、[ AWS Amplify Documentation ]を参照してください。

SDK for JavaScript をインストールする

すべてのサービスがSDK または 全てのAWS 地域ですぐに利用できない場合があります。

[npm, the Node.js package manager])を使用してAWS SDK for JavaScriptからサービスをインストールするには、コマンドプロンプトで以下のコマンドを入力し、ここではSERVICEs3のようなサービス名です。

npm install @aws-sdk/client-SERVICE

AWS SDK for JavaScript サービスクライアントパッケージの完全なリストについては、「AWS SDK for JavaScript API リファレンスガイド」を参照してください。

SDK for JavaScript をロードする

SDK のインストール後、import を使用してノードアプリケーションにクライアントパッケージをロードできます。たとえば、Amazon S3 クライアントと Amazon S3 ListBuckets コマンドをロードするには、以下を使用します。

import { S3Client, ListBucketsCommand } from "@aws-sdk/client-s3";