microsoft / microsoft/TypeScript
TS Spec doesn't match implementation re method signature definitions
Nadie ha tomado este issue todavía.
- Lenguaje dominante
- Go
- Estrellas
- 111k
- Forks
- 14.4k
- Merge medio
- 1 d 19 h
- PR fusionados (30 d)
- 117
Descripción
TS Spec § 3.9.5 says:
A method signature of the form
f < T1, T2, ... > ( p1, p2, ... ) : Ris equivalent to the property declaration
f : { < T1, T2, ... > ( p1, p2, ... ) : R }
But this is not the case with --strictFunctionTypes:
interface IFoo1 {
bar(baz?: number): void
}
class Foo1 implements IFoo1 {
bar: (baz: number) => void = (n) => void 0;
}
interface IFoo2 {
bar: { (baz?: number): void }
}
class Foo2 implements IFoo2 {
bar: (baz: number) => void = (n) => void 0; // err: Property 'bar' in type 'Foo2' is not assignable to the same property in base type 'IFoo2'.
}
I understand that the method bivarience in general is intentional as per the PR:
With this PR we introduce a --strictFunctionTypes mode in which function type parameter positions are checked contravariantly instead of bivariantly. The stricter checking applies to all function types, except those originating in method or construcor declarations
But it would be nice if the spec didn't state the syntaxes were equivalent when they aren't.
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Abre doc/spec.md en §3.9.5 y compara su afirmación de equivalencia con la excepción de strictFunctionTypes descrita en PR 18654. Actualiza la especificación para documentar correctamente la distinción entre las declaraciones de métodos y las propiedades cuyos valores son funciones; después, revisa los ejemplos del issue para confirmar que la redacción coincide con su comportamiento.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- typescript
- Área
- compilers, documentation
- Tipo de issue
- Documentación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Estado de actividad
- Estancado
- Claridad
- Bien especificado
- Aptitud para principiantes
- 58/100