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).
O que é o AWS SDK para JavaScript?
Bem-vindo ao Guia do desenvolvedor do AWS SDK para JavaScript. Este guia fornece informações gerais sobre como instalar e configurar o AWS SDK para JavaScript. Ele também mostra exemplos e tutoriais de execução de vários serviços da AWS que usam o AWS SDK para JavaScript.
O Guia de referência da API do AWS SDK para JavaScript v3 fornece uma API JavaScript para serviços da AWS. Você pode usar a API JavaScript para criar bibliotecas ou aplicativos para Node.js
Começar a usar o SDK
Se estiver tudo pronto para começar a usar o SDK, siga os exemplos em Conceitos básicos da AWS SDK para JavaScript.
Consulte para configurar seu ambiente de desenvolvimento Configurar o SDK para JavaScript.
Se você estiver atualmente usando a versão 2.x do SDK para JavaScript, consulte Migrar para a v3 para obter orientação específica.
Se estiver procurando exemplos de código para os Serviços da AWS, consulte Exemplos de código do SDK para JavaScript (v3).
Manutenção e suporte para as versões principais do SDK
Para obter informações sobre manutenção e suporte para versões principais do SDK e suas dependências subjacentes, consulte o seguinte no Guia de referência de AWS SDKs e ferramentas:
Usar o SDK com o Node.js
Node.js é um tempo de execução de plataforma cruzada para a execução de aplicativos em JavaScript no lado do servidor. Você pode configurar o Node.js em uma instância do Amazon Elastic Compute Cloud (Amazon EC2) para executar em um servidor. Você também pode usar o Node.js para gravar funções do AWS Lambda sob demanda.
O uso do SDK para Node.js é diferente da maneira como você o usa para JavaScript em um navegador da web. A diferença refere-se à maneira como você carrega o SDK e obtém as credenciais necessárias para acessar serviços da web específicos. Quando o uso de determinadas APIs diferir entre o Node.js e o navegador, essas diferenças serão destacadas.
Uso do SDK com o AWS Amplify
Para aplicativos web, móveis e híbridos baseados em navegador, você também pode usar a biblioteca AWS Amplify no GitHub
nota
Estruturas, como o Amplify, podem não oferecer o mesmo suporte a navegadores que o SDK para JavaScript. Consulte a documentação da estrutura para obter detalhes.
Uso do SDK com navegadores da web
Todos os principais navegadores são compatíveis com a execução de JavaScript. O código JavaScript em execução em um navegador da web normalmente é chamado de JavaScript no lado do cliente.
Para obter uma lista dos navegadores compatíveis com o AWS SDK para JavaScript, consulte Navegadores da Web compatíveis.
O uso do SDK para JavaScript em um navegador da web é diferente da maneira como você o usa para Node.js. A diferença refere-se à maneira como você carrega o SDK e obtém as credenciais necessárias para acessar serviços da web específicos. Quando o uso de determinadas APIs diferir entre o Node.js e o navegador, essas diferenças serão destacadas.
Uso dos navegadores na V3
A V3 permite empacotar e incluir no navegador somente os arquivos do SDK para JavaScript necessários, reduzindo a sobrecarga.
Para usar a V3 do SDK para JavaScript nas páginas HTML, empacote os módulos de cliente necessários e todas as funções JavaScript necessárias em um único arquivo JavaScript que usa Webpack e adicione-o em uma tag do script no <head> de suas páginas HTML. Por exemplo:
<script src="./main.js"></script>
nota
Para obter mais informações sobre o Webpack, consulte Empacotar aplicativos com o webpack.
Para usar a V2 do SDK para JavaScript, você adiciona uma tag de script que aponta para a versão mais recente do SDK V2. Para obter mais informações, consulte o exemplo no Guia do desenvolvedor do AWS SDK para JavaScript v2.
Casos de uso comuns
Usar o SDK para JavaScript nos scripts do navegador possibilita realizar uma série de casos de uso irrefutáveis. Veja a seguir algumas ideias para itens que você pode criar em um aplicativo de navegador usando o SDK para JavaScript para acessar vários serviços Web.
-
Crie um console personalizado para serviços da AWS no qual você acessa e combina atributos entre regiões e serviços para melhor atender às necessidades da organização ou do projeto.
-
Use o Amazon Cognito Identity para habilitar o acesso do usuário autenticado aos aplicativos de navegador e sites, incluindo o uso de autenticação de terceiros pelo Facebook e outros.
-
Use o Amazon Kinesis para processar clickstreams ou outros dados de marketing em tempo real.
-
Use o Amazon DynamoDB para persistência de dados sem servidor, como preferências de usuários individuais quanto a visitantes do site ou usuários de aplicativos.
-
Use o AWS Lambda para encapsular a lógica proprietária que você pode invocar pelos scripts do navegador sem fazer download dos scripts e revelar sua propriedade intelectual aos usuários.
Sobre os exemplos
Você pode procurar exemplos do SDK para JavaScript no Repositório de exemplos de código da AWS
Recursos
Além deste guia, os seguintes recursos online estão disponíveis para desenvolvedores do SDK para JavaScript:
-
Guia de referência de ferramentas e SDKs da AWS: contém configurações, atributos e outros conceitos fundamentais comuns entre SDKs da AWS.
-
GitHub
