Полное руководство по TypeScript с Node.js на macOS

TypeScript — это строго типизированная расширенная версия JavaScript, предоставляющая расширенные функции и удобство для разработчиков. В сочетании с Node.js вы можете использовать возможности TypeScript для создания масштабируемых и удобных в обслуживании серверных приложений в macOS. В этой статье мы рассмотрим различные методы и примеры кода для работы с TypeScript и Node.js в среде macOS.

Содержание:

  1. Настройка Node.js и TypeScript в macOS
  2. Создание проекта TypeScript
  3. Выполнение кода TypeScript с помощью Node.js
  4. Работа с модулями
  5. Использование внешних библиотек
  6. Отладка приложений TypeScript
  7. Создание и развертывание приложений TypeScript
  8. TypeScript и Express.js
  9. Интеграция TypeScript и базы данных
  10. Тестирование кода TypeScript

Метод 1. Настройка Node.js и TypeScript в macOS
Для начала работы вам необходимо установить Node.js и npm (менеджер пакетов Node) на вашей macOS. Выполните следующие действия:

  1. Установить Homebrew (менеджер пакетов для macOS):

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. Установите Node.js и npm с помощью Homebrew:

    brew install node
  3. Проверьте установку:

    node -v
    npm -v
  4. Установить TypeScript глобально:

    npm install -g typescript

Метод 2. Создание проекта TypeScript

  1. Создайте новый каталог для своего проекта:

    mkdir my-project
    cd my-project
  2. Инициализировать новый проект Node.js:

    npm init -y
  3. Создайте файл tsconfig.jsonв корневом каталоге:

    {
    "compilerOptions": {
    "module": "commonjs",
    "target": "es6",
    "outDir": "dist",
    "strict": true
    },
    "include": ["src//*.ts"],
    "exclude": ["node_modules"]
    }

Метод 3. Запуск кода TypeScript с помощью Node.js

  1. Запишите код TypeScript в файл (например, src/index.ts):

    const message: string = 'Hello, TypeScript!';
    console.log(message);
  2. Скомпилируйте код TypeScript в JavaScript:

    tsc
  3. Запустите скомпилированный код JavaScript с помощью Node.js:

    node dist/index.js

Метод 4. Работа с модулями

  1. Создайте новый файл модуля (например, src/utils.ts):

    export function addNumbers(a: number, b: number): number {
    return a + b;
    }
  2. Импортируйте и используйте модуль в своем коде TypeScript:

    import { addNumbers } from './utils';
    const result: number = addNumbers(5, 10);
    console.log(result); // Output: 15

Метод 5: использование внешних библиотек

  1. Установить внешние библиотеки с помощью npm:

    npm install axios
  2. Импортируйте и используйте библиотеку в своем коде TypeScript:

    import axios from 'axios';
    axios.get('https://api.example.com/data')
    .then(response => {
    console.log(response.data);
    })
    .catch(error => {
    console.error(error);
    });

Метод 6. Отладка приложений TypeScript

  1. Добавьте исходные карты в файл tsconfig.json:

    {
    "compilerOptions": {
    "sourceMap": true
    }
    }
  2. Установите точки останова в коде TypeScript:

function multiplyNumbers(a: number, b: number): number {
  debugger; // Set breakpoint here
  return a * b;
}
  1. Используйте флаг inspectпри запуске кода:
    node --inspect dist/index.js

Метод 7. Создание и развертывание приложений TypeScript

  1. Установите необходимые зависимости для сборки:

    npm install --save-dev typescript ts-node rimraf
  2. Добавьте сценарии сборки и запуска в свой package.json:

    {
    "scripts": {
    "start": "ts-node src/index.ts",
    "build": "rimraf dist && tsc"
    }
    }
  3. Создайте и запустите приложение:

    npm run build
    npm start

Метод 8: TypeScript и Express.js

  1. Установите Express.js и определения его типов:

    npm install express
    npm install --save-dev @types/express
  2. Создайте сервер Express.js на TypeScript (например, src/server.ts):

    import express, { Request, Response } from 'express';
    const app = express();
    const port = 3000;
    app.get('/', (req: Request, res: Response) => {
    res.send('Hello, Express!');
    });
    app.listen(Continuation)
    (app.listen(port, () => {
    console.log(`Server is running on port ${port}`);
    });
  3. Запустить сервер:

    npm start

Метод 9: интеграция TypeScript и базы данных

  1. Установите библиотеку базы данных (например, MongoDB с Mongoose):

    npm install mongoose
    npm install --save-dev @types/mongoose
  2. Подключиться к базе данных с помощью кода TypeScript:

    import mongoose from 'mongoose';
    mongoose.connect('mongodb://localhost/my-database', {
    useNewUrlParser: true,
    useUnifiedTopology: true,
    })
    .then(() => {
    console.log('Connected to MongoDB');
    })
    .catch((error) => {
    console.error('Error connecting to MongoDB:', error);
    });

Метод 10: тестирование кода TypeScript

  1. Установите среду тестирования (например, Jest) и определения ее типов:

    npm install jest
    npm install --save-dev @types/jest
  2. Напишите тест для вашего кода TypeScript (например, src/utils.test.ts):

    import { addNumbers } from './utils';
    test('adds two numbers correctly', () => {
    expect(addNumbers(2, 3)).toBe(5);
    });
  3. Запустите тесты:

    npm test

В этой статье мы рассмотрели различные методы работы с TypeScript и Node.js в macOS. Мы рассмотрели настройку среды, создание проектов, запуск кода, работу с модулями и внешними библиотеками, отладку, сборку и развертывание приложений, интеграцию с Express.js и базами данных, а также тестирование. С помощью TypeScript и Node.js вы можете создавать надежные и масштабируемые приложения на своем компьютере с macOS.