

 [適用於 JavaScript 的 AWS SDK V3 API 參考指南](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)詳細說明 第 3 版 適用於 JavaScript 的 AWS SDK (V3) 的所有 API 操作。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 什麼是 適用於 JavaScript 的 AWS SDK？
<a name="welcome"></a>

歡迎使用 適用於 JavaScript 的 AWS SDK 開發人員指南。本指南提供有關設定 和設定 的一般資訊 適用於 JavaScript 的 AWS SDK。它也會逐步引導您使用 執行各種 AWS 服務的範例和教學 適用於 JavaScript 的 AWS SDK課程。

[適用於 JavaScript 的 AWS SDK v3 API 參考指南](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)提供 AWS 服務的 JavaScript API。您可以使用 JavaScript API 來建置 [Node.js](https://nodejs.org/en/) 或瀏覽器的程式庫或應用程式。​

![\[JavaScript 環境、軟體開發套件與 Amazon Web Services 之間的關係\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/sdk-overview-v3.png)


## 開發套件入門
<a name="get-started-with-the-jssdkv3"></a>

如果您已準備好開始使用 SDK，請遵循 中的範例[開始使用適用於 JavaScript 的 AWS SDK](getting-started.md)。

若要設定開發環境，請參閱 [設定適用於 JavaScript 的 SDK](setting-up.md)。

如果您目前正在使用適用於 JavaScript 的 SDK 2.x 版，請參閱[遷移至 v3](migrating.md) 以取得特定指引。

如果您要尋找 的程式碼範例 AWS 服務，請參閱 [適用於 JavaScript (v3) 的 SDK 程式碼範例](javascript_code_examples.md)。

## 開發套件主要版本的維護與支援
<a name="sdks-major-versions-maintenance-support"></a>

如需開發套件主要版本及其基礎相依性之維護與支援的相關資訊，請參閱《[AWS 開發套件及工具參考指南](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html)》中的以下內容：
+ [AWS SDKs和工具維護政策](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html)
+ [AWS SDKs和工具版本支援矩陣](https://docs.aws.amazon.com/sdkref/latest/guide/version-support-matrix.html)

## 使用軟體開發套件搭配 Node.js
<a name="welcome_node"></a>

Node.js 是一個跨平台執行時間環境，其可用來執行伺服器端 JavaScript 應用程式。您可以在 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體上設定 Node.js，以在伺服器上執行。您也可以使用 Node.js 撰寫隨需 AWS Lambda 函數。

使用 Node.js 的開發套件與您在 web 瀏覽器使用 JavaScript 的方式不同。不同之處在於載入軟體開發套件及取得存取特定 web 服務所需登入資料的方式。當 Node.js 和瀏覽器使用特定 APIs 時，我們會指出這些差異。

## 搭配 使用 SDK AWS Amplify
<a name="welcome_amplify"></a>

對於以瀏覽器為基礎的 Web、行動和混合式應用程式，您也可以[AWS Amplify 在 GitHub 上使用程式庫](https://github.com/aws/aws-amplify)。它擴展了適用於 JavaScript 的 SDK，提供宣告式界面。

**注意**  
Amplify 等架構可能無法提供與適用於 JavaScript 的 SDK 相同的瀏覽器支援。如需詳細資訊，請參閱架構的文件。

## 搭配 Web 瀏覽器使用 SDK
<a name="welcome_web"></a>

所有主要的 Web 瀏覽器都支援執行 JavaScript。Web 瀏覽器中執行的 JavaScript 程式碼通常稱為*用戶端 JavaScript*。

如需 支援的瀏覽器清單 適用於 JavaScript 的 AWS SDK，請參閱 [支援的 Web 瀏覽器](setting-up.md#browsers-supported)。

在 Web 瀏覽器中使用適用於 JavaScript 的 SDK 與您將其用於 Node.js 的方式不同。不同之處在於載入軟體開發套件及取得存取特定 web 服務所需登入資料的方式。當 Node.js 和瀏覽器使用特定 APIs 時，我們會指出這些差異。

### 在 V3 中使用瀏覽器
<a name="v3_browsers"></a>

V3 可讓您綁定並在瀏覽器中僅包含所需的適用於 JavaScript 的 SDK 檔案，從而減少額外負荷。

若要在 HTML 頁面中使用適用於 JavaScript 的 SDK V3，您必須使用 Webpack 將必要的用戶端模組和所有必要`<head>`的 JavaScript 函數封裝至單一 JavaScript 檔案，並將其新增至 HTML 頁面 中的指令碼標籤。例如：

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

**注意**  
如需 Webpack 的詳細資訊，請參閱 [使用 Webpack 綁定應用程式](webpack.md)。

若要使用適用於 JavaScript 的 開發套件 V2，請新增指令碼標籤，以指向最新版本的 V2 開發套件。 JavaScript 如需詳細資訊，請參閱《 適用於 JavaScript 的 AWS SDK 開發人員指南 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>

在瀏覽器指令碼中使用適用於 JavaScript 的 SDK 可讓您實現許多令人信服的使用案例。以下是您可以使用適用於 JavaScript 的 SDK 存取各種 Web 服務，在瀏覽器應用程式中建置的幾個想法。
+ 為 AWS 服務建置自訂主控台，您可以在其中跨區域和服務存取和結合功能，以最符合您的組織或專案需求。
+ 使用 Amazon Cognito Identity 啟用已驗證的使用者存取您的瀏覽器應用程式和網站，包括使用來自 Facebook 和其他人的第三方身分驗證。
+ 使用 Amazon Kinesis 即時處理點擊串流或其他行銷資料。
+ 使用 Amazon DynamoDB 進行無伺服器資料持久性，例如網站訪客或應用程式使用者的個別使用者偏好設定。
+ 使用 AWS Lambda 來封裝您可以從瀏覽器指令碼叫用的專屬邏輯，而無需下載和向使用者公開您的智慧財產權。

### 關於範例
<a name="welcome_examples"></a>

您可以在程式碼範例儲存庫中瀏覽適用於 JavaScript 的 SDK 範例。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code)

### 資源
<a name="welcome_resources"></a>

除了本指南之外，適用於 JavaScript 開發人員的 SDK 也提供下列線上資源：
+ [適用於 JavaScript 的 AWS SDK V3 API 參考指南](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)
+  [AWS SDKs和工具參考指南](https://docs.aws.amazon.com/sdkref/latest/guide/)：包含設定、功能和其他在 AWS SDKs之間常見的基本概念。
+ [JavaScript 開發人員部落格](https://aws.amazon.com/blogs/developer/category/programing-language/javascript/)
+ [AWS re：Post](https://repost.aws/en/search/content?globalSearch=aws-sdk-js)
+ [AWS Code Library 中的 JavaScript 範例](https://docs.aws.amazon.com/code-library/latest/ug/javascript_3_code_examples.html)
+ [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code)
+ [發射器頻道](https://gitter.im/aws/aws-sdk-js)
+ [堆疊溢位](https://stackoverflow.com/search?tab=newest&q=aws-sdk-js)
+ [堆疊溢位問題taggedAWS -sdk-js](https://stackoverflow.com/questions/tagged/aws-sdk-js?sort=newest)
+ GitHub
  + [開發套件來源](https://github.com/aws/aws-sdk-js-v3/)
  + [文件來源](https://github.com/awsdocs/aws-sdk-for-javascript-v3)