O Guia de referência da API do AWS SDK para JavaScript V3 descreve em detalhes todas as operações da API para o AWS SDK para JavaScript versão 3 (V3).
Configurar o SDK para JavaScript
Os tópicos desta seção explicam como instalar e carregar o SDK para JavaScript para que você possa acessar os serviços Web compatíveis com o SDK.
Pré-requisitos
Instale o Node.js
Configurar um ambiente Node.js da AWS
Para configurar um ambiente Node.js da AWS no qual você possa executar seu aplicativo, use qualquer um dos seguintes métodos:
Escolha uma imagem de máquina da Amazon (AMI) com o Node.js pré-instalado. Em seguida, crie uma instância do Amazon EC2 usando essa AMI. Ao criar sua instância do Amazon EC2, selecione sua AMI no AWS Marketplace. Pesquise no AWS Marketplace por Node.js e escolha uma opção de AMI que inclua uma versão pré-instalada do Node.js (32 ou 64 bits).
Crie uma instância do Amazon EC2 e instale o Node.js. Para obter mais informações sobre como instalar o Node.js em uma instância do Amazon Linux, consulte Configuração do Node.js em uma instância do Amazon EC2.
Crie um ambiente sem servidor usando o AWS Lambda para executar o Node.js como uma função do Lambda. Para obter mais informações sobre como usar o Node.js em uma função do Lambda, consulte Modelo de programação (Node.js) no Guia do desenvolvedor do AWS Lambda.
Implante seu aplicativo do Node.js no AWS Elastic Beanstalk. Para obter mais informações sobre como usar o Node.js com Elastic Beanstalk, consulte Implantar aplicativos do Node.js no AWS Elastic Beanstalk no Guia do Desenvolvedor do AWS Elastic Beanstalk.
Crie um servidor de aplicativos do Node.js usando AWS OpsWorks. Para obter mais informações sobre como usar o Node.js com OpsWorks, consulte Criar sua primeira pilha do Node.js no Guia do usuário do AWS OpsWorks.
Navegadores da Web compatíveis
O AWS SDK para JavaScript é compatível com todos os navegadores da Web modernos.
Na versão 3.567.0 ou posterior, o SDK para JavaScript emite artefatos ES2021, compatíveis com as versões mínimas a seguir.
| Navegador | Versão |
|---|---|
| Google Chrome | Posterior à 85.0 |
| Mozilla Firefox | Posterior à 80.0 |
| Opera | Posterior à 71.0 |
| Microsoft Edge | Posterior à 85.0 |
| Apple Safari | Posterior à 14.1 |
| Internet da Samsung | Posterior à 14.0 |
Nas versões 3.183.0 a 3.566.0, o SDK para JavaScript usa artefatos ES2020, compatíveis com as versões mínimas a seguir.
| Navegador | Versão |
|---|---|
| Google Chrome | Posterior à 80.0 |
| Mozilla Firefox | Posterior à 80.0 |
| Opera | Posterior à 63.0 |
| Microsoft Edge | Posterior à 80.0 |
| Apple Safari | Posterior à 14.1 |
| Internet da Samsung | Posterior à 12.0 |
Na versão 3.182.0 ou anterior, o SDK para JavaScript usa artefatos ES5, que são compatíveis com as seguintes versões mínimas.
| Navegador | Versão |
|---|---|
| Google Chrome | Posterior à 49.0 |
| Mozilla Firefox | Posterior à 45.0 |
| Opera | Posterior à 36.0 |
| Microsoft Edge | Posterior à 12.0 |
| Windows Internet Explorer | N/D |
| Apple Safari | Posterior à 9.0 |
| Navegador do Android | Posterior à 76.0 |
| UC Browser | Posterior à 12.12 |
| Internet da Samsung | Posterior à 5.0 |
nota
Talvez as estruturas, como o AWS Amplify, não ofereçam o mesmo suporte a navegadores que o SDK para JavaScript. Consulte a Documentação do AWS Amplify para obter detalhes.
Instalar o SDK para JavaScript
Nem todos os serviços estão disponíveis imediatamente no SDK ou em todas as Regiões da AWS.
Para instalar um serviço do AWS SDK para JavaScript usando o npm, o gerenciador de pacotes Node.jsSERVICE é o nome de um serviço, como s3.
npm install @aws-sdk/client-SERVICEPara obter uma lista completa dos pacotes do cliente de serviço do AWS SDK para JavaScript, consulte o Guia de referência de API do AWS SDK para JavaScript.
Carregar o SDK para JavaScript
Depois de instalar o SDK, você pode carregar um pacote de cliente no aplicativo do seu nó usando import. Por exemplo, para carregar o cliente do Amazon S3 e o comando ListBuckets do Amazon S3, use o seguinte.
import { S3Client, ListBucketsCommand } from "@aws-sdk/client-s3";