Microsoft/TypeScript

API: incorrect declarations in types.ts

Open

#24,706 opened on 2018年6月5日

GitHub で見る
 (5 comments) (12 reactions) (0 assignees)TypeScript (48,455 stars) (6,726 forks)batch import
Breaking ChangeHelp WantedInfrastructure

説明

The --strictNullChecks PR changed some declarations in types.ts to avoid frequent assertions in the compiler's code. Unfortunately these changes make it really unsafe for API users because they no longer contain the actually nullable types: https://github.com/Microsoft/TypeScript/pull/22088#discussion_r184149465 https://github.com/Microsoft/TypeScript/pull/22088#discussion_r184155027

  • ts.Node#parent is no longer optional (which is definitely wrong for SourceFile)
  • ts.Symbol#declarations and ts.Symbol.valueDeclaration are no longer optional, but can still be undefined
  • ts.Type#symbol is no longer optional, but I guess this comment is still up to date: // Symbol associated with type (if any)

These changes should either be reverted or replaced in the published declaration files. /cc @andy-ms @weswigham

コントリビューターガイド

技術スタック
typescript
領域
api
Issue 種別
bug
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
4
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
1-2 days
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
stale
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
clear
前提条件
TypeScript strictNullChecksTypeScript compiler internalsType declaration files (.d.ts)Git and GitHub workflow
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
25
調査方針
Review the PR #22088 and the specific discussions referenced (discussion r184149465, discussion r184155027). Examine the current types.ts in the TypeScript compiler to identify the declarations for Node.parent, Symbol.declarations, Symbol.valueDeclaration, and Type.symbol. Determine whether to revert the changes or add proper optionality. Check for any follow up comments or maintainer guidance. Propose a fix that ensures type safety while maintaining API compatibility.