نحوه استفاده از TypeScript با پروژه Node.js

بسیاری از پروژه های Node.js از TypeScript برای تایپ دقیق و ویژگی های شی گرا استفاده می کنند. یاد بگیرید که چگونه فوراً شروع کنید.

TypeScript برای ساخت برنامه های پیچیده و معماری های قوی مانند میکروسرویس ها مفید است. البته، TypeScript نمی تواند کاری را انجام دهد که جاوا اسکریپت نمی تواند انجام دهد، اما می تواند پروژه های پیچیده را قابل مدیریت تر کند. تایپ دقیق و پشتیبانی TypeScript از رابط ها به این معنی است که برای برنامه نویسی شی گرا عالی است. شرکت های زیادی را دیده ایم که برای کدنویسی باطن خود به TypeScript روی آورده اند.

هیچ زمانی بهتر از اکنون برای شروع استفاده از TypeScript در پروژه Node.js وجود ندارد. اما چگونه می توانید آن را برای پروژه Node.js خود تنظیم کنید؟ در این مقاله متوجه خواهید شد.

TypeScript چیست؟

TypeScript یک نسخه کامپایل شده و کاملاً تایپ شده جاوا اسکریپت است که توسط مایکروسافت توسعه یافته و نگهداری می شود. کد TypeScript به جاوا اسکریپت تبدیل می شود.

ماهیت تایپ دقیق TypeScript به توسعه دهندگان کمک می کند تا از اشکالات کد خود جلوگیری کنند. فقط کدی را کامپایل می کند که قوانین انواع داده های مشخص شده آن را برآورده کند. این باعث می شود کد TypeScript قوی تر از همتای جاوا اسکریپت خالص خود باشد.

همچنین از برنامه نویسی تابعی و شی گرا پشتیبانی می کند. همه این ویژگی ها آن را بسیار مقیاس پذیر و مناسب برای توسعه برنامه های پیچیده می کند.

نحوه راه اندازی TypeScript در Node.JS

برای شروع استفاده از TypeScript با پروژه Node.js خود، باید چند پیکربندی را اینجا و آنجا انجام دهید. اما نگران نباشید، آسان است.

با این حال، قبل از ادامه، مطمئن شوید که بسته npm Node.js را نصب کرده اید.

یک فایل package.json را راه اندازی کنید

ترمینال خود را باز کنید و یک پوشه پروژه ایجاد کنید. سپس، این دایرکتوری جدید را وارد کرده و یک پروژه Node.js را مقداردهی اولیه کنید:

npm init

دستور بالا یک فایل package.json برای ذخیره وابستگی های شما ایجاد می کند.

TypeScript و سایر وابستگی ها را نصب کنید

بعد، ادامه دهید و TypeScript را در پروژه Node.js خود نصب کنید:

npm i -D typescript

کلمه کلیدی -D تضمین می کند که TypeScript به عنوان بخشی از devDependencies در package.json نصب می شود.

همچنین باید @types/express را نصب کنید، یک تعریف TypeScript برای Express.js:

npm install -D @types/express

سپس یک فایل tsconfig.json را مقداردهی اولیه کنید. این جزئیات گزینه های کامپایلر پایه برای پروژه شما است:

npx tsc --init

دستور بالا یک فایل tsconfig.json در پوشه ریشه پروژه شما ایجاد می کند.

همچنین Express.js را نصب کنید. اگر فقط قصد مدیریت سرورها با HTTP اولیه Node.js را دارید، ممکن است از این کار صرف نظر کنید. اما Express.js این کار را آسان می کند:

npm install express

در مرحله بعد، nodemon را نصب کنید، بسته ای که هر زمان که در کد شما تغییراتی ایجاد شود، سرور شما را به طور خودکار راه اندازی مجدد می کند. مطمئن شوید که این را به صورت سراسری نصب کنید تا کار کند:

npm install -g nodemon

TypeScript را با Node.JS پیکربندی کنید

فایل tsconfig.json را که قبلاً با استفاده از ویرایشگر کد انتخابی خود مقداردهی اولیه کرده اید، باز کنید. ممکن است موارد زیادی در این فایل وجود داشته باشد. در حالی که ممکن است این فایل را به شکل فعلی پیکربندی کنید، می‌توانید کل محتوای آن را با فایل زیر جایگزین کنید تا ساده‌تر شود.

در اینجا تمام آنچه در tsconfig.json برای شروع نیاز دارید وجود دارد:

{
  "compilerOptions": {
    "module": "commonjs",
    "esModuleInterop": true,
    "target": "es6",
    "moduleResolution": "node",
    "sourceMap": true,
    "outDir": "dist" //Specifies the transpiler directory. 
  },
  "lib": ["es2015"]
}

اکنون package.json را باز کنید. در حال حاضر پس از نصب TypeScript و Express چگونه به نظر می رسد:

در مرحله بعد، تنظیمات زیر را به آرایه اسکریپت ها اضافه کنید:

"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "npx tsc",
    "start": "node ./dist/app.js",
    "dist": "tsc -p .",
    "dev": "nodemon ./src/app.ts", //Replace this with the correct directory path for app.ts in your case
    "type": "module"
}

پیکربندی بالا به سرور شما اشاره می کند که در app.js، transpiler، شروع به کار کند. نگران نباشید، این یک فایل پیش فرض است که هنگام اجرای اسکریپت ساخت به طور خودکار در پوشه dist ایجاد می شود. بعداً این کار را انجام خواهید داد.

سپس پیکربندی اسکریپت توسعه اولیه را به عنوان app.ts مشخص می کند.

از این رو، هنگامی که محیط توسعه را راه اندازی می کنید، nodemon app.ts را اجرا می کند. Node.js سپس این را در جاوا اسکریپت در داخل app.js کامپایل می کند – که با سرور HTTP ارتباط برقرار می کند.

بعد، یک پوشه src در دایرکتوری ریشه پروژه خود ایجاد کنید. در داخل این پوشه، یک فایل TypeScript خالی ایجاد کنید و نام آن را app.ts بگذارید.

دایرکتوری Transpiler را ایجاد کنید

Transpiler یک فایل جاوا اسکریپت است که کد TypeScript را در جاوا اسکریپت اصلی کامپایل می کند. بنابراین این تضمین می کند که سرور می تواند به جای اسکریپت کاملاً تایپ شده با کد شما به عنوان جاوا اسکریپت ارتباط برقرار کند.

بنابراین در حالی که TypeScript ساختار کد را مدیریت می کند، فایل transpiler آن را در جاوا اسکریپت کامپایل می کند.

اکنون اسکریپت ساخت را اجرا کنید تا دایرکتوری dist transpiler به طور خودکار ایجاد شود:

npm run build

دستور بالا کد TypeScript شما را در جاوا اسکریپت کامپایل می کند. پوشه ایجاد شده شامل دو فایل است. app.js و app.js.map.

بسته.json را دوباره باز کنید. کلیدی را در آرایه به نام main خواهید دید. می توانید ببینید که مقدار آن به index.js اشاره می کند. این را با فهرست فایل app.js (transpiler) جایگزین کنید:

"main": "./dist/app.js",

پس از قالب بندی، package.json باید به شکل زیر باشد:

این برای بخش تنظیمات است.

یک درخواست HTTP ایجاد و اجرا کنید

اکنون سعی کنید یک درخواست HTTP را از طریق سرور Express.js ایجاد و اجرا کنید تا ببینید آیا کد شما همانطور که باید کامپایل می شود یا خیر.

داخل app.ts:

import express, {Request, Response} from 'express'
 
const app = express()
 
app.get('/', async (req: Request, res: Response)=>{
    console.log('Hello world')
    res.send('Hello world')
})
 
const port = 8080
 
app.listen(port, (): void=>{
    console.log(`App is listening at http://localhost:${port}`)
})

سپس، خط فرمان را در دایرکتوری ریشه پروژه خود باز کنید و اسکریپت dev را برای شروع پروژه خود اجرا کنید:

npm run dev

مرورگر خود را باز کنید و به localhost:8080 بروید و پاسخ (Hello world) را مشاهده خواهید کرد. اگر دستور console.log را همانطور که در مثال بالا انجام دادیم، در ترمینال نیز مشاهده خواهید کرد.

TypeScript دارای تقاضای زیاد است

تفاوت زیادی بین TypeScript و JavaScript وجود ندارد. اما اولی توسعه را با اضافه کردن تایپ دقیق آسان می کند.

TypeScript یک زبان ارزشمند در فریم ورک های فرانت اند مانند Angular است و ما نمی توانیم عملکرد و مقیاس پذیری آن را انکار کنیم. محبوب‌تر می‌شود و فرصت‌های شغلی برای توسعه‌دهندگان TypeScript همچنان در حال افزایش است.

منبع مقاله