O [Guia de referência da API do AWS SDK para JavaScript V3](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) descreve em detalhes todas as operações da API para o AWS SDK para JavaScript versão 3 (V3). 

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# O que é o AWS SDK para JavaScript?
<a name="welcome"></a>

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](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) fornece uma API JavaScript para serviços da AWS. Você pode usar a API JavaScript para criar bibliotecas ou aplicativos para [Node.js](https://nodejs.org/en/) ou o navegador.

![\[Relação entre ambientes em JavaScript, o SDK e o Amazon Web Services\]](http://docs.aws.amazon.com/pt_br/sdk-for-javascript/v3/developer-guide/images/sdk-overview-v3.png)


## Começar a usar o SDK
<a name="get-started-with-the-jssdkv3"></a>

Se estiver tudo pronto para começar a usar o SDK, siga os exemplos em [Comece a usar o AWS SDK para JavaScript](getting-started.md).

Consulte para configurar seu ambiente de desenvolvimento [Configure o SDK para JavaScript](setting-up.md).

Se você estiver atualmente usando a versão 2.x do SDK para JavaScript, consulte [Migrar para a v3](migrating.md) para obter orientação específica.

Se estiver procurando exemplos de código para os Serviços da AWS, consulte [SDK para exemplos de JavaScript código (v3)](javascript_code_examples.md).

## Manutenção e suporte para as versões principais do SDK
<a name="sdks-major-versions-maintenance-support"></a>

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](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html):
+ [AWS Política de manutenção de ferramentas e SDKs da](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html)
+ [AWS Matriz de suporte a versões de ferramentas e SDKs da](https://docs.aws.amazon.com/sdkref/latest/guide/version-support-matrix.html)

## Usar o SDK com o Node.js
<a name="welcome_node"></a>

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
<a name="welcome_amplify"></a>

Para aplicativos web, móveis e híbridos baseados em navegador, você também pode usar a [biblioteca AWS Amplify no GitHub](https://github.com/aws/aws-amplify). Ela estende o SDK para JavaScript, fornecendo uma interface declarativa.

**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
<a name="welcome_web"></a>

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](setting-up.md#browsers-supported).

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 name="v3_browsers"></a>

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](webpack.md).

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](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/getting-started-browser.html#getting-started-browser-write-sample) no Guia do desenvolvedor do AWS SDK para JavaScript v2.

### Casos de uso comuns
<a name="welcome_use_cases"></a>

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
<a name="welcome_examples"></a>

Você pode procurar exemplos do SDK para JavaScript no [Repositório de exemplos de código da AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code).

### Recursos
<a name="welcome_resources"></a>

Além deste guia, os seguintes recursos online estão disponíveis para desenvolvedores do SDK para JavaScript:
+ [Guia de referência de API do AWS SDK para JavaScript V3](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)
+  [Guia de referência de ferramentas e SDKs da AWS](https://docs.aws.amazon.com/sdkref/latest/guide/): contém configurações, atributos e outros conceitos fundamentais comuns entre SDKs da AWS. 
+ [Blog do desenvolvedor de JavaScript](https://aws.amazon.com/blogs/developer/category/programing-language/javascript/)
+ [AWS re:Post](https://repost.aws/en/search/content?globalSearch=aws-sdk-js)
+ [Exemplos de JavaScript na Biblioteca de Códigos da AWS](https://docs.aws.amazon.com/code-library/latest/ug/javascript_3_code_examples.html)
+ [Repositório de exemplos de código da AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code)
+ [Canal Gitter](https://gitter.im/aws/aws-sdk-js)
+ [Stack Overflow](https://stackoverflow.com/search?tab=newest&q=aws-sdk-js)
+ [Perguntas do Stack Overflow com a tag AWS -sdk-js](https://stackoverflow.com/questions/tagged/aws-sdk-js?sort=newest)
+ GitHub
  + [Fonte do SDK](https://github.com/aws/aws-sdk-js-v3/)
  + [Fonte de documentação](https://github.com/awsdocs/aws-sdk-for-javascript-v3)