microsoft / microsoft/TypeScript

Incorrect parse errors issued when linebreak is in mapped type `as` clause

Aperta
#53,589 6 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Bug Domain: Parser Help Wanted
Lingua principale
Go
Stelle
111k
Fork
14.3k
Merge medio
1g 19h
PR unite (30g)
117

Descrizione

Bug Report

Today, putting a linebreak before the extends keyword is a syntax error, but not a line break after the extends keyword.

Especially in the context of mapped types which use conditionals (like Omit, if you expand it), it can be very surprising if you aren't aware of this. I can see an argument for leaving it alone in the case of X5 (below), hopefully the case of Omit3 demonstrates where this can catch users by surprise.

Perhaps if nothing else, there is some way to improve the error message in this situation (Omit3 below), which is:

Mapped object type implicitly has an 'any' template type. (7039)
']' expected.(1005) (if you happen hover in just the right place over the extends)
';' expected.(1005) (if you happen hover in just the right place over the truthy part of the condition)

Which doesn't help as much as the error message in X5 below:

Declaration or statement expected. (1128) (if you hover over the extends)
'number' only refers to a type, but is being used as a value here.(2693) (if you hover over the thing right of the extends)

🔎 Search Terms

line break, linebreak, extends, newline, new line, extends keyword

🕗 Version & Regression Information

This is present since at least TypeScript 4.1 when key remapping was introduced.

  • This is the behavior in every version I tried, and I reviewed the FAQ for entries about key remapping
⏯ Playground Link

Playground link with relevant code

💻 Code
// ✅ BASELINE: normal syntax
type X1<T> = T extends number ? true : false;

type X2 = X1<1>;
//   ^? X2 = true

// ✅ works fine to have a new line after `extends`
type X3<T> = T extends
number ? true : false;

type X4 = X3<1>;
//   ^? X4 = true

// ❌ Placing a new line _before_ the `extends` is a syntax error
type X5<T> = T
extends number ? true : false;
// ^ Error: 'number' only refers to a type, but is being used as a value here. (2693)
//         ^ Error: 'number' only refers to a type, but is being used as a value here. (2693)

type X6 = X5<1>;
//   ^? X6 = 1

// ✅ This works fine in some other contexts that are less ambiguous:
type Omit2<T, K
extends keyof any> = Pick<T, Exclude<keyof T, K>>;

type Y1 = Omit<{ a: 1, b: 2 }, 'a'>;
//   ^? Y1 = { b: 2 }

// ❌ But if you use it in a remapping, it fails
type Omit3<T, K extends keyof any> = {
//                                   ^ Error: Mapped object type implicitly has an 'any' template type. (7039)
  [P in keyof T as P
    extends K ? never : P]: T[P];
//  ^ Error: ']' expected.(1005)
//              ^ Error: ';' expected.(1005)
}

type Y2 = Omit3<{ a: 1, b: 2 }, 'a'>;
//   ^? type Y3 = { a: any; b: any; }


// ✅ But if you use it in a remapping, it fails
type Omit4<T, K extends keyof any> = {
  [P in keyof T as P extends
  K ? never : P]: T[P];
}

type Y3 = Omit4<{ a: 1, b: 2 }, 'a'>;
//   ^? type Y3 = { b: 2; }
🙁 Actual behavior
  • X4 is not a syntax error: you can linebreak after an extends keyword in simple conditional types
  • X5 is a syntax error: you cannot linebreak before an extends keyword in simple conditional types
  • Omit3 is a syntax error: you cannot linebreak before an extends keyword in key remapping
  • Omit4 is not a syntax error: you can linebreak after an extends keyword in key remapping
🙂 Expected behavior

None should be syntax errors.

Omit3 is the one that I care about the most because it's the one that comes up the most when writing complex types.

here are some more real-world examples where this kind of thing is likely to come up:

here are some more real-world examples where this kind of thing is likely to come up

in these situations, it's pretty reasonable to want to put the extends on the next line.

type GreaterThanDigit<
  First extends Numeric,
  Second extends Numeric
> =
  `0123456789` extends // here
    `${string}${Second}${string}${First}${string}`
  ? true
  : false
type UnionToFnInsertion<T> =
  (T extends T ? (arg: () => T) => unknown : never) extends // here
    (arg: infer R) => unknown
  ? R
  : never
type Equal<X, Y> =
  (<T>() => T extends X ? 1 : 2) extends // here
  (<T>() => T extends Y ? 1 : 2)
  ? true
  : false

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia con il TypeScript Playground collegato e riproduci le diagnostiche per X5 e Omit3, confrontandole con X3 e Omit4. Traccia il comportamento del parser per le interruzioni di riga attorno alle clausole extends dei tipi condizionali; il lavoro è completo quando gli esempi segnalati accettano le forme previste e producono diagnostiche appropriate, con copertura di regressione per questi casi.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
typescript
Ambito
compilers
Tipo di issue
Bug
Difficoltà
4/5
Tempo stimato
3-5 giorni
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.