DEV Community

Cover image for O que há de novo no AWS SDK v3 para JavaScript?
Eduardo Rabelo
Eduardo Rabelo

Posted on

O que há de novo no AWS SDK v3 para JavaScript?

O SDK v3 da AWS para JavaScript está disponível para todo mundo desde dezembro de 2020. Um desafio que une todos os usuários da AWS: vale a pena investir seu precioso tempo nesta nova versão?

Nesse artigo, mostro os novos recursos e casos de uso em que a versão v3 mais ajuda, não importa se você usa JavaScript no front-end ou no back-end (Node.js). Vamos começar!

Paginação

Muitas APIs da AWS podem retornar uma longa lista de dados (por exemplo, listar todos os objetos em um bucket S3). Todas as APIs de lista oferecem um mecanismo de paginação para recuperar um lote por vez. Cada lote contém um token para recuperar o próximo lote ou indicar que você atingiu o fim da lista. O bom e velho código da versão v2 com callbacks era assim:

const AWS = require('aws-sdk');

const dynamodb = new AWS.DynamoDB({apiVersion: '2012-08-10'});

function fetchPage(lastEvaluatedKey, cb) {
  const params = {
    TableName: 'users',
    Limit: 100,
  };
  if (lastEvaluatedKey) {
    params.ExclusiveStartKey = lastEvaluatedKey;
  }
  dynamodb.scan(params, cb);
}

function fetchAll(cb) {
  fetchPage(null, function(err, data) {
    if (err) {
      cb(err);
    } else {
      data.Items.forEach(console.log);
      if (data.LastEvaluatedKey) {
        process.nextTick(() => fetchPage(data.LastEvaluatedKey, cb));
      } else {
        cb();
      }
    }
  });
}

fetchAll(function (err) {
  if (err) {
    // panic
    process.exit(1);
  } else {
    console.log('done');
  }
});
Enter fullscreen mode Exit fullscreen mode

Felizmente, a linguagem JavaScript evoluiu. Agora temos Promises, async / await e generators . É por isso que agora podemos escrever o seguinte usando o SDK v3:

import { DynamoDBClient, paginateScan } from '@aws-sdk/client-dynamodb';

const dynamodb = new DynamoDBClient({apiVersion: '2012-08-10'});

async function fetchAll() {
  const config = {
    client: dynamodb,
    pageSize: 100
  };
  const input = {
    TableName: 'users'
  };
  const paginator = paginateScan(config, input);
  for await (const page of paginator) {
    page.Items.forEach(console.log);
  }
}

fetchAll()
  .then(() => console.log('done'))
  .catch(() => process.exit(1));
Enter fullscreen mode Exit fullscreen mode

Estou feliz por não precisar mais escrever código de paginação. Lembre-se de que, em quase todos os cenários voltados para o usuário, você deve evitar obter todos os itens de uma vez só. Vai demorar muito e você pode ficar sem memória na execução! Acredito que os desenvolvedores de back-end se beneficiam mais com esse recurso quando escrevem código de "trabalho em lote" (batch jobs).

Promises

Muitos programadores preferem Promise ao invés de callbacks. Na versão SDK v2 usávamos callbacks dessa maneira:

const AWS = require('aws-sdk');

const dynamodb = new AWS.DynamoDB({apiVersion: '2012-08-10'});

dynamodb.getItem({/*...*/}, function(err, data) {
  // esse código é invocado assim que os resultados estiverem disponíveis
  dynamodb.updateItem({/*...*/}, function(err, data) {
    // ao usar vários callbacks, criamos o chamado "callback hell"
  });
});
Enter fullscreen mode Exit fullscreen mode

A abordagem de Promises combinada com async / await na v2 é assim:

const AWS = require('aws-sdk');  

const dynamodb = new AWS.DynamoDB({apiVersion: '2012-08-10'});  

async function demo() {}  
 const data = await dynamodb.getItem({/*...*/}).promise();  
 await dynamodb.updateItem({/*...*/}).promise();  
}  

demo()  
 .then(() => console.log('done'))  
 .catch(() => process.exit(1));
Enter fullscreen mode Exit fullscreen mode

Com o novo SDK v3, agora você pode escrever:

import { DynamoDB } from '@aws-sdk/client-dynamodb';  

const dynamodb = new DynamoDB({apiVersion: '2012-08-10'});  

async function demo() {}  
 const data = await dynamodb.getItem({/*...*/}); // Não precisamos de ".promise()"!
 await dynamodb.updateItem({/*...*/});  
}  

demo()  
 .then(() => console.log('done'))  
 .catch(() => process.exit(1));
Enter fullscreen mode Exit fullscreen mode

Este novo recurso é ótimo para desenvolvedores front-end e back-end!

Modularização e Tree Shaking

O SDK v2 empacota todos os serviços da AWS. Com o tempo, o módulo aws-sdk cresceu muito em tamanho. E esse é um desafio difícil de resolver se você usar o SDK no front-end. Ele é muito grande e deixa seu site mais lento. Dois recursos do novo SDK v3 que irão ajudar:

  • Modularização
  • Tree Shaking

Cada serviço da AWS agora é empacotado como seu próprio módulo npm. Você deseja usar o DynamoDB? Instale o pacote @aws-sdk/client-dynamodb. Precisa de S3? Instale @aws-sdk/client-s3 e assim por diante.

JavaScript hoje em dia suporta módulos ES6. Combinado com ferramentas como esbuild ou webpack , podemos eliminar o código JS que "não é usado". Isso é chamado de tree shaking. Se você quiser se beneficiar do tree shaking, não use a sintaxe que é compatível com o SDK v2:

import { DynamoDB } from '@aws-sdk/client-dynamodb';  

const dynamodb = new DynamoDB({apiVersion: '2012-08-10'});  

await dynamodb.getItem(/*...*/);
Enter fullscreen mode Exit fullscreen mode

Ao invés disso, use:

import { DynamoDBClient, GetItemCommand } from '@aws-sdk/client-dynamodb';  

const dynamodb = new DynamoDBClient({apiVersion: '2012-08-10'});  

await dynamodb.send(new GetItemCommand(/*...*/));
Enter fullscreen mode Exit fullscreen mode

Agora, o tree shaking pode entrar em ação e remover todos os comandos que você nunca usa! Os desenvolvedores de front-end vão adorar!

O tempo de execução do AWS Lambda em Node.js não inclui o SDK v3. Se você deseja manter seu código de função lambda o menor possível, você ainda deve usar o SDK v2 porque você não precisa incluí-lo em seu arquivo ZIP.

As partes ruins

Características adicionais

  • Se você deseja escrever plugins para o SDK da AWS (talvez porque você tenha adicionado suporte ao X-Ray), você vai se interessar pelo no novo middleware.
  • v3 é implementado em TypeScript. Também temos tipos para o SDK v2. Portanto, não é uma grande mudança para nós, clientes da AWS.

AWS SDK v3 para JavaScript em ação

Assista essa vídeo para aprender como usamos o novo SDK em nosso Chatbot para AWS Monitoring.

Resumo

Os desenvolvedores de front-end devem começar a usar o SDK v3 hoje mesmo. Use objetos de comando para remover todo o código não utilizado! Para desenvolvedores de back-end, não vejo muitos benefícios, a menos que seu código esteja paginando muito :). Se seu back-end é executado no lambda, lembre-se de que o SDK v3 não faz parte do tempo de execução do AWS Lambda! Se você planeja migrar, verifique o guia oficial de migração.

Créditos

Top comments (0)