メむンコンテンツぞスキップ
芋出し画像

TypeScriptが遞ばれる理由 AIで曞いたコヌドを、型の怜査ずlintで公開の前に確かめる

    りェブの画面を動かすプログラムは、長く JavaScript で曞かれおきたした。最近は、生成AIを䜿っおコヌドを曞く開発が広がり、人が行ず぀曞いたわけではないコヌドが増えおいたす。そのコヌドが正しいかを、本番の公開の前にどう確かめるかが、開発で倧切になっおいたす。

    そこで遞ばれるこずが増えおいるのが、JavaScript に「型」の曞き方を足した TypeScript です。GitHub の幎次報告Octoverseによるず、TypeScript は幎月に、GitHub で最も䜿われる蚀語になりたした7。同じ報告は、型の仕組みがあいたいさを枛らし、LLM倧芏暡蚀語モデルの誀りを本番の前に芋぀ける7ず説明しおいたす。

    この蚘事では、TypeScript が JavaScript ず比べおどのような利点を持぀のかを、NDシステムズが制䜜した぀のサむトの実際の蚭定を䟋に敎理したす。぀は事業の公匏サむトの ndsystems.jp、もう぀は梚蟲園「梚屋さん」のホヌムペヌゞです。

    梚屋さんは、犏岡県久留米垂藀山町で梚を栜培・盎売しおいる梚蟲園です。NDシステムズは、梚屋さんのホヌムペヌゞず、受泚や請求を管理する事務管理システムの制䜜を担圓しおいたす。

    前半では、型の怜査tsc、npm run lintESLintによる点怜、それらを自動で行う流れを、実際に動かした結果ずあわせお玹介したす。埌半では、これらの怜査が、AIで曞いたコヌドを公開の前に確かめる仕組みずしお、どのように働くのかを芋たす。本文の1のような番号は、抌すず出兞のペヌゞが開きたす。

    画像
    この蚘事で扱うこず

    TypeScript は「型を曞ける JavaScript」

    TypeScript の公匏サむトは、冒頭で TypeScript を「JavaScript with syntax for types型の曞き方を備えた JavaScript」1ず玹介しおいたす。぀たり、TypeScript は JavaScript ず別の蚀語ずいうより、JavaScript に型の曞き方を足したものです。

    型は、倀の皮類のこずです。「数」「文字」「決たった遞択肢のどれか」のように、倉数や関数の受け取る倀がどの皮類なのかを、コヌドの䞭に曞いおおけたす。

    ブラりザヌが盎接動かせるのは JavaScript です。TypeScript のハンドブック公匏の解説曞によるず、型の曞き方は JavaScript の䞀郚ではないため、型の郚分は取り陀かれおから動かされたす。型の曞き方は「プログラムの実行時の動䜜を倉えない」2ものです。

    画像
    TypeScript で曞いたコヌドは、型の郚分を取り陀いた JavaScript になっおから動く

    型は、動かすずきに働くものではありたせん。曞いおいる途䞭ず、公開の前の点怜で働くものです。この点が、次の節から芋る利点の土台になりたす。

    JavaScript では、誀りが「動かしたずき」たで芋えにくい

    梚屋さんのホヌムペヌゞず事務管理システムの党䜓像は、次の蚘事でたずめおいたす。

    梚屋さんのホヌムペヌゞには、梚の予玄の受付状況を衚瀺する郚分がありたす。受付状況は「予玄受付䞭」「受付停止䞭」「受付終了」「受付開始前」の぀で、コヌドの䞭では open・paused・closed・not_started ずいう぀の倀で衚しおいたす。

    同じ凊理を、型のない JavaScript で曞いお、わざず぀の誀りを入れお動かしおみたした。

    1. 予玄受付䞭を衚す open を、opne ず曞き間違える

    2. 衚瀺する文字の項目名 label を、lable ず曞き間違える

    3. 数を受け取る関数に、文字の "800" を枡す

    // 同じ内容を JavaScript で曞き、そのたた動かす
    // getReservationStatusMeta は、サむトず同じ凊理を JavaScript で写したもの
    const current = "opne";
    const meta = getReservationStatusMeta(current);
    console.log(meta.label);
    console.log(meta.lable);
    function total(price, shipping) { return price + shipping; }
    console.log(total(6000, "800"));

    Node.jsブラりザヌの倖で JavaScript を動かす実行環境で動かすず、結果は次のずおりでした。

    予玄状況: opne
    undefined
    6000800

    ぀ずも、゚ラヌで止たりたせん。「予玄状況: opne」ずいう芋慣れない衚瀺、䞭身のない undefined、6000 ず 800 を足すはずが文字ずしお぀ながった「6000800」が、そのたた出おきたす。

    画像
    JavaScript では、぀の誀りが゚ラヌにならず、おかしな衚瀺のたた動いおしたう

    このような誀りは、その画面を実際に開き、衚瀺がおかしいず気づくたで芋぀かりたせん。開く人が少ない画面や、特定の条件のずきだけ通る凊理では、本番の公開のあずに、お客様が先に芋぀けるこずもありたす。

    型の怜査tscは、動かす前に誀りを芋぀ける

    TypeScript で曞くず、同じ誀りを動かす前に芋぀けられたす。TypeScript のハンドブックは、コヌドが動く前にバグプログラムの誀りを芋぀けるツヌルずしお「静的な型チェッカヌ」2を挙げおいたす。静的は、プログラムを動かさずにコヌドを読んで調べるこずを指したす。

    梚屋さんのホヌムペヌゞでは、受付状況の型を次のように曞いおいたす。瞊線|は「どれか぀」ずいう意味で、この型の倀は぀の文字のどれかに限られたす。

    export type ReservationStatus =
      | "open"
      | "paused"
      | "closed"
      | "not_started";
    画像
    受付状況の型。぀の倀のどれかに限られ、それ以倖の文字は受け付けない

    この型を䜿い、先ほどず同じ぀の誀りを TypeScript で曞きたした。梚屋さんのホヌムペヌゞの開発甚のリポゞトリコヌドの保管堎所に確認甚のファむルずしお䞀時的に眮き、型の怜査のコマンドを実行したした確認のあずは削陀し、本番のコヌドには入れおいたせん。

    npx tsc --noEmit

    tsc は、TypeScript のコンパむラヌTypeScript を JavaScript に倉換し、あわせお型を怜査するツヌルです。--noEmit を付けるず、JavaScript のファむルを曞き出さず、型の怜査だけを行いたす。結果は次のずおりで、぀の誀りがすべお、行ず列の䜍眮぀きで瀺されたした長い行は䞀郚を省いおいたす。

    demoTypo.ts(4,7): error TS2322: Type '"opne"' is not assignable to type 'ReservationStatus'.
    demoTypo.ts(8,18): error TS2551: Property 'lable' does not exist on type ... Did you mean 'label'?
    demoTypo.ts(14,25): error TS2345: Argument of type 'string' is not assignable to parameter of type 'number'.

    ぀目は「"opne" は ReservationStatus の型に入れられない」、぀目は「lable ずいう項目はない。label のこずでは」、぀目は「文字stringを、数numberを受け取る匕数に枡せない」ずいう意味です。぀目では、正しい綎りの候補たで瀺されおいたす。

    画像
    型の怜査は、動かす前に぀の誀りをすべお芋぀け、堎所ず理由を瀺す

    怜査は、゚ラヌがあるず「倱敗」の終了コヌドコマンドの結果を衚す番号で終わりたす。この性質を䜿うず、゚ラヌが぀でも残っおいれば公開の手順を止める、ずいう仕組みを䜜れたす。この仕組みは、埌の節で玹介したす。

    ぀のサむトの tsconfig.json

    TypeScript の怜査の決たりは、tsconfig.json ずいう蚭定ファむルに曞きたす。぀のサむトの蚭定から、䞻な項目を抜き出すず次のずおりです。

    // ndsystems.jp
    "allowJs": false,
    "strict": true,
    "noEmit": true,
    
    // 梚屋さんのホヌムペヌゞ
    "allowJs": true,
    "strict": true,
    "noEmit": true,

    strict は、厳しい怜査をたずめお有効にする指定です。ハンドブックによるず、strict を true にするず䞀連の厳しい怜査が䞀床に有効になり、䞭でも重芁なものずしお、型が分からないたた any䜕でもよい型ずしお扱われる倉数を゚ラヌにする noImplicitAny ず、null や undefined倀がないこずの扱いを明確にさせる strictNullChecks が挙げられおいたす2。぀のサむトは、どちらも strict を有効にしおいたす。

    noEmit は、tsc に JavaScript のファむルを曞き出させない指定です。Next.jsReact でりェブサむトを䜜るための仕組みを䜿うサむトでは、公開甚のファむルぞの倉換は Next.js が行うため、tsc は怜査だけを担圓したす。Next.js の倉換は型を取り陀くだけで型の怜査を䌎わないため、型の怜査は tsc で別に行う必芁がありたす。

    違いは allowJs です。これは、JavaScript のファむルを TypeScript の怜査の察象に含め、TypeScript のファむルから読み蟌めるようにするかを決める指定です。

    • ndsystems.jpallowJs は false です。サむトのコヌドは、すべお TypeScript で曞いおいたす。

    • 梚屋さんのホヌムペヌゞallowJs は true です。コヌドの倧郚分は TypeScript ですが、品皮や䟡栌のデヌタなど、䞀郚のファむルに JavaScript が残っおいたす。

    画像
    ぀のサむトの tsconfig.json。どちらも strict で怜査し、梚屋さんのホヌムペヌゞは JavaScript のファむルの混圚を蚱しおいる

    allowJs を true にするず、JavaScript で曞いた既存のサむトを、ファむルごずに少しず぀ TypeScript に移せたす。ただし、残った JavaScript のファむルの䞭身は、型の怜査では厳しく確認されたせん。TypeScript に移したファむルから順に、型の怜査の効果が及ぶず考えるのが適切です。Next.js の公匏の説明でも、既存のプロゞェクトに TypeScript を加えるには、ファむルの名前を .ts・.tsx に倉えればよい3ずされおいたす。すべおを䞀床に曞き盎さなくおよいこずも、TypeScript が広たった理由の぀ず考えられたす。

    npm run lint型では芋぀からない誀りを芋぀ける

    型の怜査ずは別に、lintリントずいう点怜がありたす。lint は、コヌドの曞き方の䞭から、誀りに぀ながりやすい圢や、決たりに反する曞き方を芋぀ける点怜です。JavaScript ず TypeScript の lint には、ESLint ずいうツヌルが広く䜿われおいたす。

    ESLint の公匏の説明によるず、ESLint は JavaScript のコヌドの䞭の決たった圢を芋぀けお報告するツヌルで、目的はコヌドの䞀貫性を高め、バグを避けるこずです4。

    型の怜査ず lint は、芋おいるずころが違いたす。梚屋さんのホヌムペヌゞで、型ずしおは正しいものの、React画面を郚品の組み合わせで䜜る仕組みの決たりに反するコヌドを曞き、䞡方を動かしたした。

    // ① 条件の䞭でフックuseStateを呌んでいる
    if (showCount) {
      const [count, setCount] = useState(0);
      ...
    }
    // ② Next.js の画像の郚品を䜿わず、img を盎接曞いおいる
    return <img src="/images/pear.jpg" alt="梚" />;

    型の怜査tscは、゚ラヌなしで終わりたした。䞀方、npm run lint は、次の぀を報告しお倱敗したした。

    7:31  error    React Hook "useState" is called conditionally. ...  react-hooks/rules-of-hooks
    11:10 warning  Using `<img>` could result in slower LCP and higher bandwidth. ...  @next/next/no-img-element
    
    ✖ 2 problems (1 error, 1 warning)

    ぀目は、useState のようなフックReact の画面の郚品に、状態などの機胜を足す関数を条件の䞭で呌んでいるずいう誀りです。React のフックは、衚瀺のたびに同じ順番で呌ぶ決たりがあり、条件の䞭で呌ぶず、状態の察応がずれる原因になりたす。぀目は、Next.js の画像の郚品next/imageを䜿わず img を盎接曞いおいるため、衚瀺が遅くなるおそれがあるずいう譊告です。

    画像
    型の怜査は通っおも、lint は React ず Next.js の決たりに反する曞き方を芋぀ける

    梚屋さんのホヌムペヌゞ譊告も぀で倱敗にする

    梚屋さんのホヌムペヌゞの package.jsonプロゞェクトの蚭定ずコマンドの䞀芧を曞くファむルでは、lint のコマンドを次のように曞いおいたす。

    "lint": "eslint . --ext .js,.jsx,.ts,.tsx --max-warnings=0"

    最埌の --max-warnings=0 は、譊告を䜕件たで蚱すかの指定です。ESLint の説明によるず、このオプションで譊告の件数の䞊限を決めるず、䞊限を超えたずきに倱敗の状態で終わらせられたす5。䞊限をにするず、譊告が件でもあれば倱敗になりたす。

    実際に、img の譊告だけが出るコヌドで動かすず、「ESLint found too many warnings (maximum: 0).」ず衚瀺され、倱敗で終わりたした。同じコヌドでも、この指定を倖すず成功で終わりたす。

    ndsystems.jpTypeScript 向けの決たりも足す

    ndsystems.jp の lint の蚭定eslint.config.mjsでは、Next.js が甚意しおいる぀の決たりの組み合わせを読み蟌んでいたす。

    import nextVitals from "eslint-config-next/core-web-vitals"
    import nextTs from "eslint-config-next/typescript"
    
    export default defineConfig([
      ...nextVitals,
      ...nextTs,
      ...
    ])

    Next.js の公匏の説明によるず、core-web-vitals は、衚瀺の速さなどの指暙に圱響する決たりを、譊告から゚ラヌに匕き䞊げた組み合わせです6。typescript は、TypeScript に特有の決たりを加える組み合わせです6。

    たずえば、型を any䜕でもよい型にするず、型の怜査をすり抜けられおしたいたす。ndsystems.jp の蚭定で any を䜿ったコヌドを点怜するず、「Unexpected any. Specify a different typeany は䜿わず、別の型を指定する」ずいう゚ラヌになりたした。

    画像
    ぀のサむトの lint の蚭定。梚屋さんのホヌムペヌゞは譊告も止め、ndsystems.jp は TypeScript 向けの決たりも読み蟌む

    なお、Next.js 16 では、以前の「next lint」のコマンドがなくなりたした6。ndsystems.jp では、lint のコマンドを「eslint .」ず、ESLint を盎接呌ぶ圢で曞いおいたす。

    npm run の名前は、プロゞェクトごずに決める

    「npm run lint」の lint は、package.json の scripts の欄で、プロゞェクトごずに決めた呌び名です。ndsystems.jp の scripts の欄には、怜査に関わるものずしお次の぀がありたす。

    "lint": "eslint .",
    "typecheck": "tsc --noEmit",
    "verify": "npm run typecheck && npm run lint",

    npm run typecheck で型の怜査、npm run lint で lint を行い、npm run verify で、その぀を続けお行いたす。「&&」は、前のコマンドが成功したずきだけ、次のコマンドに進むずいう意味です。

    画像
    package.json の scripts。npm run のあずの名前は、プロゞェクトごずに決めた呌び名

    npm run の仕組みず、ホヌムペヌゞ制䜜の䞭での Node.js の働きは、次の蚘事で取り䞊げたした。

    公開の前に、自動で怜査する

    型の怜査ず lint は、手元で動かすだけでは、動かし忘れるこずがありたす。そこで぀のサむトでは、GitHubコヌドの保管ず共有のサヌビスにコヌドを送ったずきや、プルリク゚スト倉曎を main に取り蟌む前の確認の䟝頌を出したずきに、怜査を自動で行う仕組みGitHub Actionsを蚭定しおいたす。倉曎をこために取り蟌み、そのたびに自動でビルドず怜査を行う進め方を CI継続的むンテグレヌションず呌び、この仕組みはその䞭心になりたす。

    • 梚屋さんのホヌムペヌゞどのブランチ䜜業の流れにコヌドを送っおも、lint → 型の怜査 → 公開甚のビルド公開するファむルを䜜る䜜業の順に行いたす。本番の元になる main のブランチに取り蟌む前に、この怜査が成功しおいるこずを条件にしおいたす。

    • ndsystems.jp型の怜査 → lint → テスト → 蚀葉づかいの怜査 → 公開甚のビルド → 参照しおいる画像や資料のファむルの怜査の順に行いたす。main に取り蟌むためのプルリク゚ストを出したずきず、main に取り蟌んだあずに動きたす。

    画像
    プルリク゚ストなどのたびに、型の怜査ず lint を自動で行い、通ったこずを確認しおから main に取り蟌む

    怜査のどれかが倱敗するず、GitHub の画面に倱敗の印が付き、倱敗した手順ず、その出力どのファむルのどの行かが蚘録されたす。型の誀りや lint の誀りを、本番の公開の前に止められるのは、この仕組みがあるためです。

    プルリク゚ストず、自動の怜査チェックの関係は、次の蚘事で取り䞊げたした。

    公開甚のビルドず、型の怜査の関係

    Next.js は、TypeScript の型の゚ラヌがあるず、本番甚のビルドnext buildを倱敗させたす3。そのため、型の誀りが残ったたた公開甚のファむルが䜜られるこずは、通垞はありたせん。

    ただし、蚭定の ignoreBuildErrors を䜿うず、このビルドの䞭の型の怜査を省けたす。Next.js の公匏の説明は、省く堎合は、ビルドや公開の手順の䞭で必ず型の怜査を行うよう求めおおり、そうしないず「非垞に危険」3だずしおいたす。

    ndsystems.jp では、公開先の環境でのビルドが、型の怜査の段階で止たっおしたうこずがありたした。そこで、公開先の環境のビルドに限っお型の怜査を省き、その代わりに、CI ず手元のビルドで型の怜査を行う圢にしおいたす。省いた理由ず、代わりに怜査しおいる堎所は、蚭定ファむルのコメントに曞き残しおいたす。

    倧芏暡な開発で TypeScript が遞ばれる理由

    ここたでの䟋は、どれも小さな誀りです。小さなサむトなら、画面を開いお確認すれば芋぀けられるかもしれたせん。ファむルが増え、改修に関わる人が増え、期間が長くなるほど、型の怜査の䟡倀は倧きくなりたす。

    名前を倉えたずき、盎すべき堎所をすべお瀺す

    ndsystems.jp では、拠点の地域名犏岡県久留米垂を、サむト党䜓の蚭定の area ずいう項目にたずめおいたす。詊しに、この項目の名前を region に倉え、型の怜査を動かしたした。

    結果は、この項目を䜿っおいる耇数のファむルのすべおの堎所で、「area ずいう項目はない」ずいう゚ラヌになりたした。名前を倉えたずきに盎すべき堎所が、もれなく䞀芧になりたす。型の情報が少ない JavaScript では、文字の怜玢に頌る堎面が倚くなり、芋萜ずした堎所は、その画面を開くたで分かりたせん。

    実際の改修では、゚ディタヌの名前の倉曎の機胜を䜿うず、型の情報をもずに、䜿っおいる堎所をたずめお曞き換えられたす。そのうえで型の怜査を動かし、盎し挏れがないこずを確認したす。

    画像
    項目の名前を倉えるず、型の怜査が、盎すべき堎所をファむルをたたいですべお瀺す

    コヌドが「説明曞」になる

    型は、関数が䜕を受け取り、䜕を返すのかを、コヌドの䞭に曞いた説明でもありたす。TypeScript の公匏サむトは、型によっお゚ディタヌコヌドを曞く゜フトずの連携が密になり、゚ディタヌの䞭で早く誀りを芋぀けられる1ずしおいたす。

    時間がたっおから自分のコヌドを読み盎すずきや、別の人が改修するずきにも、型を芋れば倀の皮類が分かりたす。入力の途䞭で候補が瀺されるため、項目名の曞き間違いも、曞いおいる途䞭で気づけたす。

    調査で芋る TypeScript の広がり

    TypeScript が広く䜿われおいるこずは、開発者を察象にした耇数の調査からも読み取れたす。

    • GitHub の Octoverse幎・幎GitHub は、幎の報告で、TypeScript が幎月に、貢献者プロゞェクトに参加した人の数で、Python ず JavaScript を抜いお最も䜿われる蚀語になったず報告しおいたした。その月の貢献者は䞇人でした7。幎もその順䜍は倉わらず、䜍が TypeScript、䜍が Python、䜍が JavaScript でした8。

    • State of JavaScript 2025JavaScript の開発者を察象にした調査です。JavaScript ず TypeScript を曞く時間の割合を尋ねた質問では、回答した䞇人のうち人玄が「すべお TypeScript」ず答え、「すべお JavaScript」は人玄でした11。

    • Stack Overflow Developer Survey 2026過去幎に本栌的な開発に䜿った蚀語を尋ねた質問で、回答した䞇人のうち、JavaScript は.、TypeScript は.でした10。

    画像
    ぀の調査で芋る TypeScript の広がり。察象ず数え方は、調査ごずに異なる

    ぀の調査は、察象も数え方も違いたす。Stack Overflow の調査では JavaScript の方が倚く、JavaScript がなくなるわけではありたせん。TypeScript は JavaScript に型を足したものなので、TypeScript が広がるこずは、JavaScript の䞊で型を䜿う開発が増えおいる、ず読むのが自然です。

    TypeScript を䜿うずきの泚意点

    型の怜査は、公開の前に倚くの誀りを芋぀けたすが、できないこずもありたす。䞻なものは次の぀です。

    • 動かしおいるずきのデヌタは怜査しない

    • any や「as」で、怜査をすり抜けられる

    • 動䜜の正しさは、テストで確認する

    画像
    型の怜査が芋぀けられないもの぀ず、それぞれを補う方法

    動かしおいるずきのデヌタは、怜査しない

    型の怜査は、コヌドを動かす前に行いたす。そのため、倖郚から受け取るデヌタAPI のレスポンスなどが、曞いた型ず違う圢で届いおも、型の怜査では芋぀かりたせん。

    たずえば、受付状況を倖郚から受け取り、䞭身が "opne" だった堎合を考えたす。コヌドの䞊では型が合っおいおも、届いた倀そのものは、動かすたで分かりたせん。

    梚屋さんのホヌムペヌゞの受付状況の衚瀺は、受け取った倀を文字stringずしお扱い、぀の倀のどれかに圓たるかをコヌドで確認しおいたす。圓たらないずきは「予玄状況: opne」のように受け取った倀をそのたた瀺し、画面が止たらないようにしおいたす。前の節の JavaScript の実隓で出た「予玄状況: opne」は、この確認の働きによる衚瀺です。

    受け取るデヌタの項目が倚いずきは、デヌタの圢を動かしおいるずきに確認するラむブラリヌ共通の郚品を䜿う方法もありたす。

    画像
    倖郚から届く倀は、動かしおいるずきに初めお分かる。受け取る偎のコヌドで確認する

    any や「as」で、怜査をすり抜けられる

    any䜕でもよい型を付けた倀は、型の怜査の察象から倖れたす。たた、as は「この倀はこの型だ」ず蚀い切る曞き方で、TypeScript はその蚀い切りを信じお怜査を進めたす。

    梚屋さんのホヌムペヌゞの開発甚のリポゞトリで、倖郚から届いた "opne" ずいう文字を as で ReservationStatus ず蚀い切り、any を付けた倀の項目名を lable ず曞き間違えたコヌドを曞きたした。型の怜査ぱラヌなしで終わり、動かすず「opne」ず「undefined」が出たした。

    any は、前の節で玹介した lint の決たりndsystems.jp の蚭定で゚ラヌにできたす。as は、倖郚のデヌタを受け取る堎所など、必芁な所に限っお䜿い、その手前で倀を確認するのが基本です。

    画像
    any ず as を䜿うず、型の怜査ぱラヌなしで通っおしたう

    動䜜の正しさは、テストで確認する

    型が合っおいおも、蚈算の手順や条件の誀りは芋぀かりたせん。たずえば、送料を「足す」はずの関数で、誀っお「匕く」ず曞いおも、数を受け取っお数を返すずいう型は合っおいたす。

    実際に、この誀りを入れた関数を型の怜査にかけるず、゚ラヌなしで終わりたした。そこで、「商品円ず送料円なら、合蚈は円」ずいうテスト期埅する結果ず実際の結果を比べる確認のコヌドを曞いお動かすず、結果は円で、テストは倱敗したした。

    ndsystems.jp の CI では、型の怜査ず lint に加えお、テストも動かしおいたす。型の怜査、lint、テストは、それぞれ違う皮類の誀りを芋぀けるため、組み合わせお䜿いたす。

    画像
    型が合っおいおも蚈算の誀りは残る。期埅する結果を曞いたテストで芋぀ける

    APIずは䜕か、倖郚のサヌビスの API ず、自分のアプリの䞭の API の違いは、次の蚘事で取り䞊げたした。

    AIで曞いたコヌドを、公開の前に機械で確かめる

    ここたで芋おきた型の怜査、lint、CI は、人が曞いたコヌドにも同じように働きたす。そのうえで、これらの䟡倀がいっそう倧きくなっおいるのが、生成AIを䜿っおコヌドを曞く堎面です。

    生成AIの䞭心にある LLM は、次に続く蚀葉を予枬しお぀ず぀付け足し、文章を䜜りたす。この仕組みは、次の蚘事で取り䞊げたした。

    コヌドも同じ仕組みで䜜られるため、芋た目は敎っおいおも、そのたたではコンパむルコヌドを動かせる圢に倉換するこずできない出力になるこずがありたす9。存圚しない項目名や、型の合わない倀の受け枡しは、その代衚的な䟋です。

    AIを䜿う開発で、TypeScript が遞ばれおいる

    GitHub の幎の Octoverse は、TypeScript が䜍になった背景ずしお、開発者が、゚ヌゞェント䜜業を任せられる AIを䜿った開発を本番で信頌しやすくする、型のある蚀語ぞ移り぀぀ある7ずしおいたす。䞻なフロント゚ンドのフレヌムワヌク画面を䜜るための土台のほずんどが、新しいプロゞェクトを TypeScript で䜜るようになったこず7も、広がりの理由に挙げおいたす。

    幎の Octoverse によるず、幎に䜜られたリポゞトリのうち、゚ヌゞェントを䜿った圢跡のあるものでは、TypeScript を䞻な蚀語ずする割合がで、圢跡のないもののを䞊回りたした8。GitHub は、この結果から、゚ヌゞェントを䜿う開発者は「゚ヌゞェントの出力を怜査しやすい蚀語」を遞ぶ傟向があるず読み取れる、ずしおいたす8。

    ただし、これは傟向を瀺す数字です。゚ヌゞェントを䜿ったこずが、蚀語を遞ぶ原因になったずたでは瀺しおいたせん。

    画像
    ゚ヌゞェントを䜿った圢跡のあるリポゞトリでは、TypeScript を䞻な蚀語ずする割合が高い

    LLM のコヌドのコンパむルの゚ラヌは、倚くが型の誀り

    LLM に TypeScript のコヌドを曞かせお調べた研究がありたす。ミュンドラヌ氏らの研究幎では、広く䜿われるプログラミングの課題集HumanEval ず MBPPを TypeScript に盎したもので、孊習枈みの䞭身重みが公開されおいる぀の LLM の出力を調べたした9。その結果、コンパむルの゚ラヌのうち、平均でが型の怜査の倱敗によるものでした9。

    この数字は、課題集の短い問題ず、研究で䜿った特定のモデルでの結果です。実際のプロゞェクトや、すべおの AI に圓おはたるものではありたせん。たた、コンパむルの゚ラヌの内蚳なので、動かしたずきに初めお分かる誀り蚈算の誀りなどは含みたせん。

    それでも、LLM の曞いたコヌドの誀りのうち、少なくずもコンパむルの段階で芋぀かるものの倚くは、型の怜査で芋぀かる皮類のものだず読めたす。型のない JavaScript では、これらの誀りの倚くが、動かすたで衚に出たせん。

    画像
    研究の条件では、コンパむルの゚ラヌの平均が型の怜査の倱敗だった

    型ず怜査が、AIで曞くコヌドを支える぀の理由

    型の怜査ず lint が、AIで曞くコヌドの確認で圹に立぀理由は、䞻に次の぀です。

    1. 型が、守るべき決たりを䌝える受付状況の ReservationStatus の型があれば、䜿える倀は぀だけだず、コヌドの䞭に曞かれおいたす。型ず合わないコヌドは、人が曞いたものでも AI で曞いたものでも、怜査で止たりたす。

    2. ゚ラヌが、堎所ず理由぀きで返るtsc の゚ラヌは、どのファむルの䜕行目で、䜕が合わないのかを文字で瀺したす。前の節の「Did you mean 'label'?」のように、盎し方の候補たで瀺すこずもありたす。この出力は、人だけでなく、コマンドを実行できる゚ヌゞェントも読めるため、゚ラヌを読んで盎す䜜業を、くり返し行わせられたす。

    3. 人の確認を、意図に集䞭できる曞き間違いや倀の皮類の取り違えを機械の怜査に任せるず、人のレビュヌでは、凊理が意図どおりか、お客様の芁望に合っおいるかずいった、機械では刀断できない点に時間を䜿えたす。

    画像
    型ず怜査が、AIで曞くコヌドの確認を支える぀の理由

    怜査が通るたで盎し、最埌に人が確かめる

    ゚ヌゞェントの䞭には、コマンドを実行できるものがありたす。その堎合、コヌドを曞かせたあずに、npm run verify のような怜査のコマンドを動かさせ、゚ラヌが出れば、その堎所ず理由をもずに盎させる、ずいう流れを組めたす。怜査は成功か倱敗かを終了コヌドで返すため、「通るたでくり返す」ずいう区切りが、機械にもはっきり分かりたす。

    手元の怜査がすべお通ったら、人がレビュヌをしたす。そのうえでプルリク゚ストを出し、CI でもう䞀床同じ怜査を行っおから main に取り蟌みたす。手元ず CI の䞡方で怜査するこずで、怜査の動かし忘れや、手元の環境だけで通っおしたうこずを防げたす。

    画像
    怜査が通るたで盎し、人のレビュヌず CI を通っおから main に取り蟌む

    怜査を「黙らせる」盎し方に泚意する

    怜査の゚ラヌを消す方法は、原因を盎すこずだけではありたせん。泚意点の節で芋た any や as のほかに、次の行の型の゚ラヌを無芖させる @ts-ignore ずいうコメントもありたす。゚ラヌを消すこずだけを目暙にするず、これらの曞き方で怜査を通しおも、結果は「成功」になっおしたいたす。

    ndsystems.jp の開発甚のリポゞトリに確認甚のファむルを䞀時的に眮き、぀の曞き方を点怜したした確認のあずは削陀しおいたす。

    • anylint の節で芋たずおり、lint で゚ラヌになりたす。

    • @ts-ignore型の怜査は通りたしたが、lint で「Use "@ts-expect-error" instead of "@ts-ignore"」@ts-ignore ではなく、@ts-expect-error を䜿うずいう゚ラヌになりたした。@ts-ignore は、次の行の誀りがなくなっおも気づかれないたた残るため、誀りがなくなるず知らせる @ts-expect-error を䜿うよう求めるものです。

    • as型を蚀い切った行は、型の怜査も lint も、゚ラヌなしで通りたした。

    lint で止められる曞き方は lint で止め、止められないものは人のレビュヌで確かめたす。差分倉曎した郚分に any・as・@ts-ignore などが増えおいないかを芋お、増えおいれば、なぜ必芁なのかを確認したす。

    画像
    ゚ラヌを黙らせる぀の曞き方。lint で止められるものず、人が確かめるもの

    機械の怜査を通ったこずは、型ず決たりに合っおいるこずの確認です。凊理の内容が意図どおりかの確認ではありたせん。動䜜はテストで、意図は人のレビュヌで確かめたす。

    たずめ

    TypeScript は、JavaScript に型の曞き方を足したものです。型は動かすずきの動䜜を倉えず、曞いおいる途䞭ず、公開の前の点怜で働きたす。

    • 型の怜査tsc --noEmitは、曞き間違いや倀の皮類の取り違えを、動かす前に堎所ず理由぀きで瀺す

    • npm run lintESLintは、型では芋぀からない React・Next.js の決たりに反する曞き方を芋぀ける

    • GitHub Actions の CI で、プルリク゚ストなどのたびに䞡方を自動で行い、通ったこずを確認しおから main に取り蟌む

    • ファむルが倚く、改修に関わる人が倚く、期間が長い開発ほど、名前の倉曎などで型の怜査の䟡倀が倧きくなる

    • AIで曞いたコヌドも、型の怜査・lint・テストを通るたで、゚ラヌの堎所ず理由をもずに盎し、最埌に人がレビュヌする

    • any・as・@ts-ignore のような、゚ラヌを黙らせる曞き方は、lint で止めるか、人のレビュヌで確かめる

    画像
    たずめ

    AIでコヌドを曞く堎面が増えるほど、人が行ず぀読む前に、機械が誀りを芋぀ける仕組みの䟡倀は倧きくなりたす。ndsystems.jp ず梚屋さんのホヌムペヌゞは、どちらもこの考え方で、型の怜査ず lint を公開の前の手順に組み蟌んでいたす。

    免責事項

    この蚘事は、筆者が調べたこずや経隓をもずに、執筆時点の内容をたずめたものです。コマンドの結果は、執筆時点の各ツヌルのバヌゞョンで確認したもので、バヌゞョンや蚭定によっお倉わるこずがありたす。調査ず研究の数字は、それぞれの察象・条件ず数え方によるものです。

    ツヌルの仕様は倉わるこずがありたす。実際の開発では、公匏の情報で最新の内容を確認し、本番に反映する前に怜蚌しおください。この蚘事の内容を利甚しお生じた損害に぀いおは、責任を負いかねたす。

    NDシステムズに぀いお

    NDシステムズは、犏岡県久留米垂を拠点に、ホヌムペヌゞの制䜜、業務に合わせた事務のシステムの開発、AI・DX支揎を行っおいたす。たずはお気軜に無料盞談でご盞談ください。

    参考文献

    1. TypeScriptTypeScript 公匏サむト英語

    2. The BasicsTypeScript Handbook英語

    3. TypeScriptNext.js Docs英語

    4. Getting Started with ESLintESLint英語

    5. Command Line Interface ReferenceESLint英語

    6. ESLint PluginNext.js Docs英語

    7. Octoverse: A new developer joins GitHub every second as AI leads TypeScript to #1The GitHub Blog英語

    8. Octoverse: Commits, pushes, reach new highs in 2026 as developers build with agentsThe GitHub Blog英語

    9. Type-Constrained Code Generation with Language ModelsN. MÃŒndler ほか、arXiv、2025幎英語

    10. Programming, scripting, and markup languagesStack Overflow Developer Survey 2026英語

    11. UsageState of JavaScript 2025英語

     
     
    犏岡県久留米垂のNDシステムズです。IT・AI、語孊、䌚蚈、数孊、九州北郚の颚景などに぀いお、調べお考えたこずを曞いおいたす。蚘事は筆者が個人ずしお調べた執筆時点の内容で、専門家の助蚀ではありたせん。最新の情報は出兞でご確認ください。

    あなたぞのおすすめ