Typescript (TS) jest niesamowity! Sprawia, że ​​kod jest bardziej przejrzysty, łatwy w utrzymaniu i zapobiega typowym błędom. Zdecydowałeś, że to najlepszy wybór dla Twojego zespołu, a teraz chcesz go przyjąć. Brawo!

Ups… Adopcja TS nie jest taka łatwa, jak się wydaje . Jest to bardzo żmudne i czasochłonne. Jak więc przeprowadzić migrację z JS do TS? Z czatem GPT! Jeszcze nie .
Ale użycie ts-migrate może ułatwić pracę .

O ts-migrate

ts-migrate to narzędzie ułatwiające migrację kodu do TypeScript. Pobiera projekt JavaScript (JS) lub częściowy TypeScript i przekazuje kompilujący projekt TypeScript.

Użyliśmy ts-migrate do konwersji 1000 plików w naszym projekcie z JS na TS. Oszczędziło nam to cenny czas i sprawiło, że cały proces był bardzo wygodny.

Instalacja i konfiguracja TS

Przed rozpoczęciem procesu migracji musimy zainstalować i skonfigurować TS:

• Zainstaluj pakiet TS:

npm install typescript --save-dev

npx tsc --init

npm install --save-dev @types/react

Użyjemy ts-migrate do migracji naszych plików JS do TS:

• Zainstaluj ts-migrate:

npm install --save-dev ts-migrate

yarn ts-migrate rename <project-dir> --sources <specific-dir>

yarn ts-migrate migrate <project-dir> --sources <specific-dir>/file.tsx

Przykład

Stworzyłem ten przykładowy projekt ts-migrate, aby zademonstrować proces migracji. Sklonuj go na swój komputer:

git clone https://github.com/shai20099/ts-migrate-example.git

yarn ts-migrate rename ./ --sources ./src/examples

Następnym krokiem jest zastosowanie skryptu migracji do przykładowego pliku:

yarn ts-migrate migrate ./ --sources ./src/examples/example.ts

Uwaga: gdy ts-migrate nie może automatycznie naprawić problemów z TS, pozostawia komentarz @ts-expect-error ze szczegółami błędu.

Uwaga: Podczas gdy ts-migrate umieszcza typy w zmiennych tam, gdzie jest to potrzebne, nadal musimy pamiętać o zmianie dowolnych typów na określone typy.

Uwaga: ts-migrate używa wtyczek do automatycznego wprowadzania zmian. Możesz zmusić go do automatycznego podejmowania większej liczby działań, tworząc niestandardowe wtyczki dla swojego projektu. Więcej szczegółów znajduje się tutaj .

Streszczenie

ts-migrate to narzędzie ułatwiające migrację kodu z JS do TS. Jego głównym celem jest stworzenie skompilowanego kodu, a także automatycznie naprawia niektóre błędy za pomocą wtyczek. Chociaż ts-migrate nie jest w pełni zautomatyzowanym narzędziem, uważamy, że jest bardzo przydatne, ponieważ wykrywa luki między JS a TS, naprawia to, co może, i zaznacza kod, który należy poprawić ręcznie. Oszczędza to znaczną ilość czasu w procesie migracji, zwłaszcza gdy masz wiele plików do migracji.

Powodzenia!