TypeScript Deep Dive 日本語版
  • TypeScript Deep Dive 日本語版
  • TypeScript入門 & 環境構築
    • なぜTypeScriptを使うのか?
  • JavaScript
    • 等価演算子の同一性
    • リファレンス
    • nullとundefined
    • this
    • クロージャ
    • Number型
    • Truthy
  • モダンなJavaScriptの機能
    • クラス
      • Classes Emit
    • アロー関数
    • 残余引数(Restパラメータ)
    • let
    • const
    • 分割代入
    • スプレッド演算子
    • for...of
    • Iterator
    • テンプレートリテラル
    • Promise
    • ジェネレータ
    • async await
  • プロジェクトの環境設定
    • コンパイルコンテキスト
      • tsconfig.json
      • コンパイル対象ファイルの設定
    • 宣言空間
    • ファイルモジュール
      • ファイルモジュールの詳細
      • global.d.ts
    • 名前空間
    • 動的インポート
  • Node.js & TypeScriptのプロジェクト作成
  • React & TypeScriptのプロジェクト作成
  • TypeScriptの型システム
    • JavaScriptからの移行ガイド
    • @types パッケージ (DefinitelyTyped)
    • アンビエント宣言(declare)
      • 型定義ファイル
      • グローバル変数の宣言
    • インターフェース
    • Enum
    • lib.d.ts
    • 関数の型
    • 呼び出し可能オブジェクト
    • Type Assertion(型アサーション)
    • Freshness
    • 型ガード
    • リテラル型
    • Readonly
    • ジェネリック型
    • 型推論
    • 型の互換性
    • never
    • 判別可能なUnion型
    • Index signature(インデックス型)
    • 型の移動
    • 例外のハンドリング
    • ミックスイン
  • JSX
    • React
    • React以外のJSX
  • オプション
    • noImplicitAny
    • strictNullChecks
  • TypeScriptのエラー
    • エラーの理解
    • 一般的なエラー
  • NPM
  • テスト
    • Jest
    • Cypress
  • ツール
    • Prettier
    • Husky
    • Changelog
  • その他のヒント
    • String Based Enums
    • Nominal Typing
    • Stateful Functions
    • Bind is Bad
    • Currying
    • Type Instantiation
    • Lazy Object Literal Initialization
    • Classes are Useful
    • Avoid Export Default
    • Limit Property Setters
    • outFile caution
    • JQuery tips
    • static constructors
    • singleton pattern
    • Function parameters
    • Build Toggles
    • Barrel
    • Create Arrays
    • Typesafe Event Emitter
  • スタイルガイド(コーディング規約)
  • TypeScriptコンパイラの内側
    • Program
    • AST
      • TIP: Visit Children
      • TIP: SyntaxKind enum
      • Trivia
    • Scanner
    • Parser
      • Parser Functions
    • Binder
      • Binder Functions
      • Binder Declarations
      • Binder Container
      • Binder SymbolTable
      • Binder Error Reporting
    • Checker
      • Checker Diagnostics
      • Checker Error Reporting
    • Emitter
      • Emitter Functions
      • Emitter SourceMaps
    • Contributing
GitBook提供
このページ内
  • セットアップ
  • Forkのセットアップ
  • Testの実行
  • ベースライン(Baselines)
  • テストのカテゴリ
  • Compilerテスト
  • テストのデバッグ
  • More

役に立ちましたか?

  1. TypeScriptコンパイラの内側

Contributing

前へEmitter SourceMaps

最終更新 2 年前

役に立ちましたか?

TypeScriptはであり、チームはコミュニティのインプットを歓迎します。

セットアップ

凄く簡単です:

git clone https://github.com/Microsoft/TypeScript.git
cd TypeScript
npm install -g jake
npm install

Forkのセットアップ

当然、あなたはMicrosoft/TypeScriptをupstreamリモートとしてセットアップし、自分の_fork_(GitHub _fork_ボタンを使用)をoriginとしてセットアップする必要があります。

git remote rm origin
git remote rm upstream
git remote add upstream https://github.com/Microsoft/TypeScript.git
git remote add origin https://github.com/basarat/TypeScript.git

さらに、私はbas/のようなブランチを使って、ブランチリストをよりクリーンに表示させたいと思っています。

Testの実行

JakeFileにはたくさんのtestオプションとbuildオプションがあります。すべてのテストをjake runtestsで実行することができます。

ベースライン(Baselines)

ベースラインは、TypeScriptコンパイラの期待された出力に変更があるかどうかを管理するために使用されます。ベースラインはtest/baselinesに配置されています。

  • Reference(期待された)ベースライン: tests/baselines/reference

  • (このテスト実行の中で)生成されたベースライン: tests/baselines/local(このフォルダは**.gitignore**にあります)

これらのフォルダ間に相違がある場合、テストは失敗します。BeyondCompareやKDiff3のようなツールで2つのフォルダを比較することができます。

生成されたファイルのこれらの変更が正しいものであるなら、jake baseline-acceptを使ってベースラインを受け入れます。このreferenceベースラインへの変更はコミットできるgit diffとして表示されます。

すべてのテストを実行しない場合は、jake baseline-accept[soft]を使用します。これは新しいファイルをコピーするだけで、referenceディレクトリ全体を削除しないことに注意してください。

テストのカテゴリ

異なるシナリオに対して異なるカテゴリがあります。そして、異なるテストインフラに対してでさえもそうです。ここではそれらのうちのいくつかを説明します。

Compilerテスト

これらはファイルのコンパイルを確認します:

  • 期待どおりのエラーを生成すること

  • 期待通りのJSを生成すること

  • 型が期待どおりに識別されること

  • Symbolが期待どおりに識別されること

これらの期待は、ベースラインのインフラストラクチャを使用して検証されます。

Compilerテストの作成

テストは tests/cases/compilerに新しいファイルyourtest.tsを追加することで作成できます。テストを実行するとすぐに、ベースラインに失敗するはずです。これらのベースラインを受け入れて(gitでそれらを表示させるために)、それらがあなたが期待しているものになるように微調整してください...そしてテストが通るようにしてください。

jake runtests tests = compilerを使ってこれらをすべて単独で実行するか、jake runtests tests=compiler/yourtestを使って新しいファイルだけを実行してください。

私はしばしばjake runtests tests=compiler/yourtest || jake baseline-accept[soft]を実行し、gitでdiffを取得します。

テストのデバッグ

jake runtests-browser tests=theNameOfYourTestとブラウザ内でのデバッグは、通常、非常にうまく行きます。

More

Remoによる記事:

GitHubにあるOSS
https://dev.to/remojansen/learn-how-to-contribute-to-the-typescript-compiler-on-github-through-a-real-world-example-4df0