TypeScript tutorial for AWS Cloud9

In a terminal session in the AWS Cloud9 IDE, confirm whether TypeScript is already installed by running the command line TypeScript compiler with the --version option. (To start a new terminal session, on the menu bar, choose Window, New Terminal.) If successful, the output contains the TypeScript version number. If TypeScript is installed, skip ahead to Step 2: Add code.

tsc --version

Confirm whether npm is already installed by running npm with the --version option. If successful, the output contains the npm version number. If npm is installed, skip ahead to step 10 in this procedure to use npm to install TypeScript.

npm --version

Run the yum update for (Amazon Linux) or apt update for (Ubuntu Server) command to help ensure the latest security updates and bug fixes are installed.

For Amazon Linux:

sudo yum -y update

For Ubuntu Server:

sudo apt update

To install npm , begin by running the following command to download Node Version Manager ( nvm ). ( nvm is a simple Bash shell script that's useful for installing and managing Node.js versions. For more information, see Node Version Manager on the GitHub website.)

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash

To start using nvm , either close the terminal session and start it again, or source the ~/.bashrc file that contains the commands to load nvm .

. ~/.bashrc

Confirm that nvm is installed by running nvm with the --version option.

nvm --version

Install the latest version 16 of Node.js by running nvm . ( npm is included in Node.js.)

nvm install v16

Confirm that Node.js is installed by running the command line version of Node.js with the --version option.

node --version

Confirm that npm is installed by running npm with the --version option.

npm --version

Install TypeScript by running npm with the -g option. This installs TypeScript as a global package in the environment.

npm install -g typescript

Confirm that TypeScript is installed by running the command line TypeScript compiler with the --version option.

tsc --version

In the AWS Cloud9 IDE, create a file named hello.ts. (To create a file, on the menu bar, choose File, New File. To save the file, choose File, Save.)

In a terminal in the IDE, from the same directory as the hello.ts file, run npm to install the @types/node library.

npm install @types/node

This adds a node_modules/@types/node folder in the same directory as the hello.ts file. This new folder contains Node.js type definitions that TypeScript needs later in this procedure for the console.log and process.argv properties that you will add to the hello.ts file.

Add the following code to the hello.ts file:

console.log('Hello, World!');

console.log('The sum of 2 and 3 is 5.');

const sum: number = parseInt(process.argv[2], 10) + parseInt(process.argv[3], 10);

console.log('The sum of ' + process.argv[2] + ' and ' +
  process.argv[3] + ' is ' + sum + '.');

In the terminal, from the same directory as the hello.ts file, run the TypeScript compiler. Specify the hello.ts file and additional libraries to include.

tsc hello.ts --lib es6

TypeScript uses the hello.ts file and a set of ECMAScript 6 (ES6) library files to transpile the TypeScript code in the hello.ts file into equivalent JavaScript code in a file named hello.js.

In the Environment window, open the hello.js file.

On the menu bar, choose Run, Run Configurations, New Run Configuration.

On the [New] - Idle tab, choose Runner: Auto, and then choose Node.js.

For Command, type hello.js 5 9. In the code, 5 represents process.argv[2], and 9 represents process.argv[3]. (process.argv[0] represents the name of the runtime (node), and process.argv[1] represents the name of the file (hello.js).)

Choose Run, and compare your output. When you're done, choose Stop.

Hello, World!
The sum of 2 and 3 is 5.
The sum of 5 and 9 is 14.

In the AWS Cloud9 IDE, in the same directory as the hello.js file in previous steps, create a file named s3.ts.

From a terminal in the AWS Cloud9 IDE, in the same directory as the s3.ts file, enable the code to call Amazon S3 operations asynchronously by running npm twice to install the async library for TypeScript and again for JavaScript.

npm install @types/async # For TypeScript.
npm install async        # For JavaScript.

Add the following code to the s3.ts file:

import * as async from 'async';
import * as AWS from 'aws-sdk';

if (process.argv.length < 4) {
  console.log('Usage: node s3.js <the bucket name> <the AWS Region to use>\n' +
    'Example: node s3.js my-test-bucket us-east-2');
  process.exit(1);
}

const AWS = require('aws-sdk'); // To set the AWS credentials and AWS Region.
const async = require('async'); // To call AWS operations asynchronously.

const s3: AWS.S3 = new AWS.S3({apiVersion: '2006-03-01'});
const bucket_name: string = process.argv[2];
const region: string = process.argv[3];

AWS.config.update({
  region: region
});

const create_bucket_params: any = {
  Bucket: bucket_name,
  CreateBucketConfiguration: {
    LocationConstraint: region
  }
};

const delete_bucket_params: any = {
  Bucket: bucket_name
};

// List all of your available buckets in this AWS Region.
function listMyBuckets(callback): void {
  s3.listBuckets(function(err, data) {
    if (err) {

    } else {
      console.log("My buckets now are:\n");

      for (let i: number = 0; i < data.Buckets.length; i++) {
        console.log(data.Buckets[i].Name);
      }
    }

    callback(err);
  });
}

// Create a bucket in this AWS Region.
function createMyBucket(callback): void {
  console.log("\nCreating a bucket named '" + bucket_name + "'...\n");

  s3.createBucket(create_bucket_params, function(err, data) {
    if (err) {
      console.log(err.code + ": " + err.message);
    }

    callback(err);
  });
}

// Delete the bucket you just created.
function deleteMyBucket(callback): void {
  console.log("\nDeleting the bucket named '" + bucket_name + "'...\n");

  s3.deleteBucket(delete_bucket_params, function(err, data) {
    if (err) {
      console.log(err.code + ": " + err.message);
    }

    callback(err);
  });
}

// Call the AWS operations in the following order.
async.series([
  listMyBuckets,
  createMyBucket,
  listMyBuckets,
  deleteMyBucket,
  listMyBuckets
]);

In the terminal, from the same directory as the s3.ts file, run the TypeScript compiler. Specify the s3.ts file and additional libraries to include.

tsc s3.ts --lib es6

TypeScript uses the s3.ts file, the AWS SDK for JavaScript in Node.js, the async library, and a set of ECMAScript 6 (ES6) library files to transpile the TypeScript code in the s3.ts file into equivalent JavaScript code in a file named s3.js.

In the Environment window, open the s3.js file.

On the menu bar, choose Run, Run Configurations, New Run Configuration.

On the [New] - Idle tab, choose Runner: Auto, and then choose Node.js.

For Command, type s3.js YOUR_BUCKET_NAME THE_AWS_REGION , where YOUR_BUCKET_NAME is the name of the bucket you want to create and then delete, and THE_AWS_REGION is the ID of the AWS Region to create the bucket in. For example, for the US East (Ohio) Region, use us-east-2. For more IDs, see Amazon Simple Storage Service (Amazon S3) in the Amazon Web Services General Reference.

Choose Run, and compare your output. When you're done, choose Stop.

My buckets now are:

Creating a new bucket named 'my-test-bucket'...

My buckets now are:

my-test-bucket

Deleting the bucket named 'my-test-bucket'...

My buckets now are: