Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Type definition for TilemapLayer.getTileAt is wrong

Abierto Apto para principiantes
#7,396 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 2 días

@hkbughk ya está trabajando en esto.

Desde el 12/10/2026.

  • #7398 de @hkbughk — abierto

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
70/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
javascript, typescript
Área
game-dev

Línea de trabajo

El problema es el tipo de retorno declarado de getTileAt() en Phaser.Tilemaps.TilemapLayer, que indica Phaser.Tilemaps.Tile pero puede devolver null cuando las coordenadas x/y quedan fuera de la capa. Busca la declaración de tipos de ese método y comprueba si el tipo de retorno debería incluir null. Está terminado cuando la declaración coincide con el comportamiento en tiempo de ejecución y el código de reproducción del issue ya no compila sin una comprobación de null.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Version

  • Phaser Version: 4.2.1
  • Operating system: Linux
  • Browser: not relevant

Description

When using a Phaser.Tilemaps.TilemapLayer object, it exposes the method getTileAt(). The return type of that method according to the type definition is Phaser.Tilemaps.Tile. However, it could also return null if the given x/y coordinates are not within layer bounds.

Example Test Code

getTileId(tx:number, ty:number, layer: Phaser.Tilemaps.TilemapLayer): number {
  return layer.getTileAt(tx, ty).index ?? 0
}

The typescript compiler will happily accept this code but passing in values for tx and ty that are outside the layer boundaries will cause Cannot read properties of null (reading 'index') at runtime.

If I put an optional chaining operator (?) there, I would get the error Unnecessary optional chain on a non-nullish value and only if I manually type coerce it into as Phaser.Tilemaps.Tile | null the compiler does not complain.

Additional Information

Lenguaje dominante
JavaScript
Estrellas
40.5k
Forks
7.2k
Métricas de merge de PR
Sin PR fusionados en 30 d

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de phaserjs/phaser

Todos los issues de phaserjs/phaser

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.