כיצד להמיר פרויקט JavaScript ל-TypeScript

המרת פרויקט JavaScript ל-TypeScript יכולה לשפר את איכות הקוד ותחזוקה על ידי הוספת בדיקת סוג סטטית. מדריך זה מספק תהליך שלב אחר שלב להמרת פרויקט JavaScript קיים ל-TypeScript.

שלב 1: התקן את TypeScript

התחל בהוספת TypeScript לפרויקט. זה נעשה באמצעות npm או חוט.

npm install typescript --save-dev

שלב 2: צור קובץ תצורה של TypeScript

צור קובץ tsconfig.json כדי להגדיר את TypeScript. קובץ זה מציין את אפשרויות המהדר ואת הקבצים שיש לכלול בהידור.

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

שלב 3: שנה את שם קבצי JavaScript ל-TypeScript

שנה את השם של קובצי ה-JavaScript מ-.js ל-.ts (או .jsx ל-.tsx אם משתמשים ב-React). זה מאפשר ל-TypeScript לעבד קבצים אלה.

• עבור קבצים המכילים JSX, שנה את שמם ל-.tsx.
• עבור קבצים עם קוד TypeScript בלבד, שנה את שמם ל-.ts.

שלב 4: הוסף הגדרות סוג

הוסף הגדרות סוג עבור ספריות צד שלישי המשמשות בפרויקט. אלה זמינים כחבילות @types ב-npm.

npm install @types/node @types/express --save-dev

שלב 5: תקן שגיאות TypeScript

הרכיב את הפרויקט באמצעות TypeScript וטפל בכל שגיאה או בעיות סוג. TypeScript יספק משוב על אי התאמה של סוג ובעיות אחרות.

npx tsc

שלב 6: עדכן סקריפטים לבנות

עדכן סקריפטים לבנות ב-package.json כדי להשתמש ב-TypeScript. שנה סקריפטים כדי לכלול הידור TypeScript.

"scripts": {
  "build": "tsc",
  "start": "node dist/index.js"
}

שלב 7: בדוק את האפליקציה

הפעל בדיקות כדי לוודא שקוד TypeScript שהומר פועל כמצופה. ודא שהאפליקציה מתנהגת כהלכה לאחר ההמרה.

מַסְקָנָה

המרת פרויקט JavaScript ל-TypeScript כרוכה בהתקנת TypeScript, הגדרת המהדר, שינוי שמות של קבצים, הוספת הגדרות סוג ופתרון שגיאות. תהליך זה עוזר למנף את התכונות של TypeScript לבטיחות סוגים ותחזוקת קוד טובים יותר.