ユーザーランドの移行

Node.js は、「ユーザーランド」(Node 自身ではなく、あなたが書くコード) のソースコードに対して、新機能の採用や破壊的変更による影響を受けるソースコードのアップグレードを容易にするためのマイグレーションを提供します。これらは、Next.js, React, Tailwind といった他の主要プロジェクトとも協力している codemod との連携で行われます。Node.js のマイグレーションは nodejs/userland-migrations リポジトリにあり、@nodejs/userland-migrations チームによって管理されています。

公式のマイグレーションは codemod レジストリ内の @nodejs 名前空間の下で公開されています。これらは Node.js のメンバーによってレビューおよび/または作成されたものです。Node.js によってレビューされていない非公式のマイグレーションも利用可能です。

マイグレーションは、プロジェクトのソースコードを変更して、以下のような新しいデザインパターンを適用します。

cd path/to/your/project
npx codemod@latest @nodejs/correct-ts-specifiers

引用されたマイグレーションは、従来の TypeScript のインポートを、以下のような標準準拠の指定子に変換します。

import Foo from './foo';