O Guia de referência da API do AWS SDK for JavaScript V3 descreve em detalhes todas as operações da API para o AWS SDK for 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á.

Agrupe aplicativos com o webpack

O uso de módulos de código por aplicativos Web nos scripts do navegador ou no Node.js cria dependências. Esses módulos de código podem ter dependências próprias, o que resulta em uma coleção de módulos interligados que seu aplicativo exige para funcionar. Para gerenciar dependências, você pode usar um empacotador de módulos, como webpack.

O empacotador de módulos webpack analisa o código do seu aplicativo, procurando por instruções import ou require, para criar pacotes que contenham todos os ativos de que o seu aplicativo precisa. Isso é feito para que os ativos sejam facilmente apresentados em uma página da web. O SDK para JavaScript pode ser incluído webpack como uma das dependências a serem incluídas no pacote de saída.

Para obter mais informações sobrewebpack, consulte o agrupador de módulos webpack em. GitHub

Instale o webpack

Para instalar o empacotador de módulos webpack, primeiro você deve ter o npm, o gerenciador de pacotes do Node.js, instalado. Digite o comando a seguir para instalar a webpack CLI e JavaScript o módulo.

npm install --save-dev webpack

Para usar o módulo path para trabalhar com caminhos de arquivos e diretórios, que são instalados automaticamente com o webpack, talvez seja necessário instalar o pacote path-browserify do Node.js.

npm install --save-dev path-browserify

Configurar o webpack

Por padrão, o Webpack procura por um JavaScript arquivo nomeado webpack.config.js no diretório raiz do seu projeto. Esse arquivo especifica as opções de configuração. Veja a seguir um exemplo de um arquivo de webpack.config.js configuração para a WebPack versão 5.0.0 e posterior.

// Import path for resolving file paths
var path = require("path");
module.exports = {
  // Specify the entry point for our app.
  entry: [path.join(__dirname, "browser.js")],
  // Specify the output file containing our bundled code.
  output: {
    path: __dirname,
    filename: 'bundle.js'
  },
   // Enable WebPack to use the 'path' package.
   resolve:{
  fallback: { path: require.resolve("path-browserify")}
  }
  /**
  * In Webpack version v2.0.0 and earlier, you must tell 
  * webpack how to use "json-loader" to load 'json' files.
  * To do this Enter 'npm --save-dev install json-loader' at the 
  * command line to install the "json-loader' package, and include the 
  * following entry in your webpack.config.js.
  * module: {
    rules: [{test: /\.json$/, use: use: "json-loader"}]
  }
  **/
};

Neste exemplo, browser.js é especificado como ponto de entrada. O ponto de entrada é o arquivo que o webpack usa para iniciar a pesquisa por módulos importados. O nome do arquivo da saída é especificado como bundle.js. Esse arquivo de saída conterá tudo o que JavaScript o aplicativo precisa para ser executado. Se o código especificado no ponto de entrada importar ou exigir outros módulos, como o SDK para JavaScript, esse código será agrupado sem a necessidade de especificá-lo na configuração.

Execute o webpack

Para criar um aplicativo para usar o webpack, adicione o seguinte ao objeto scripts no seu arquivo package.json.

"build": "webpack"

Veja a seguir um exemplo de arquivo package.json que demonstra a adição do webpack.

{
  "name": "aws-webpack",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "webpack"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "@aws-sdk/client-iam": "^3.32.0",
    "@aws-sdk/client-s3": "^3.32.0"
  },
  "devDependencies": {
    "webpack": "^5.0.0"
  }
}

Para criar seu aplicativo, digite o comando a seguir.

npm run build

Em seguida, o agrupador de webpack módulos gera o JavaScript arquivo que você especificou no diretório raiz do seu projeto.

Use o pacote webpack

Para usar o pacote no script de um navegador, você pode incorporar o pacote usando uma tag <script>, conforme mostrado no exemplo a seguir.

<!DOCTYPE html>
<html>
    <head>
        <title>Amazon SDK with webpack</title>
    </head> 
    <body>
        <div id="list"></div>
        <script src="bundle.js"></script>
    </body>
</html>

Pacote para Node.js

Você pode usar o webpack para gerar pacotes executados no Node.js especificando node como um destino na configuração.

target: "node"

Isso é útil ao executar um aplicativo do Node.js em um ambiente no qual o espaço em disco é limitado. Aqui está um exemplo de configuração do webpack.config.js com o Node.js especificado como o destino de saída.

// Import path for resolving file paths
var path = require("path");
module.exports = {
  // Specify the entry point for our app.
  entry: [path.join(__dirname, "browser.js")],
  // Specify the output file containing our bundled code.
  output: {
    path: __dirname,
    filename: 'bundle.js'
  },
  // Let webpack know to generate a Node.js bundle.
  target: "node",
   // Enable WebPack to use the 'path' package.
   resolve:{
  fallback: { path: require.resolve("path-browserify")}
   /**
   * In Webpack version v2.0.0 and earlier, you must tell 
   * webpack how to use "json-loader" to load 'json' files.
   * To do this Enter 'npm --save-dev install json-loader' at the 
   * command line to install the "json-loader' package, and include the 
   * following entry in your webpack.config.js.
   module: {
    rules: [{test: /\.json$/, use: use: "json-loader"}]
  }
  **/
};