JSDocTypeLiteral.jsdocPropertyTags returns only the first tag

Abierto
  • ¿Algo no está bien?
#64,899 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@icecold009 ya está trabajando en esto.

Desde el 21/10/2026.

  • #64913 de @icecold009 — abierto

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
35/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Estancado
Stack tecnológico
typescript
Área
api, tooling

Línea de trabajo

Start with the JSDocPropertyTags definition in tools/scripts/tsc/ast.json and the getter generation in tools/scripts/tsc/generate-encoder.ts; the issue links a related report, #64864. Trace how raw child arrays are encoded and how generated getters handle list properties. Done when jsdocPropertyTags exposes all three tags as a node list while child traversal remains correct; an open pull request is already linked.

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

Descripción

Bug
🔎 Search Terms

jsdocPropertyTags, JSDocTypeLiteral, JSDocPropertyTag, typedef property, native API, sync API, NodeList

🕗 Version & Regression Information

This is the behavior in every v7 version I tried: 7.0.2 (typescript/unstable/*), 7.1.0-beta, and 7.1.0-dev.20261021.1. In 6.0, jsDocPropertyTags holds all the tags.

⏯ Playground Link

No response

💻 Code
import {API} from 'typescript/sync';
import {createFileSystem} from 'typescript/fs';

const api = new API({cwd: '/'});
const snapshot = api.createSnapshot({
    openProjects: ['/tsconfig.json'],
    fileSystem: createFileSystem([
        ['/tsconfig.json', JSON.stringify({files: ['/input.js'], compilerOptions: {allowJs: true, noLib: true}})],
        ['/input.js', `/**
 * @typedef {Object} Events
 * @property {string} a
 * @property {string} b
 * @property {string} c
 */
export const x = 1;`],
    ]),
});
const sourceFile = snapshot.getProjects()[0].program.getSourceFile('/input.js');
const literal = sourceFile.statements[0].jsDoc[0].tags[0].typeExpression;

console.log(literal.jsdocPropertyTags.length, literal.jsdocPropertyTags.name?.text);

const walked = [];
literal.forEachChild(node => { walked.push(node.name.text); });
console.log(walked);

api.close();
🙁 Actual behavior
undefined a
[ 'a', 'b', 'c' ]

jsdocPropertyTags is the first JSDocPropertyTag node, not a list. forEachChild still visits all three tags.

🙂 Expected behavior

jsdocPropertyTags is a node list containing all three tags, as jsDocPropertyTags is in 6.0.

Additional information about the issue

JSDocPropertyTags is a raw []*Node in tools/scripts/tsc/ast.json ("list": "raw"), so the encoder writes the tags as direct children of the node, with no NodeList entry. generateTSNodeGenerated in tools/scripts/tsc/generate-encoder.ts only treats nodeList and modifierList as lists, so this property gets a single-node getter that returns child 0.

Possibly related: #64864.

Lenguaje dominante
Go
Estrellas
112k
Forks
15.4k
Merge medio
3 d 1 h
PR fusionados (30 d)
136

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

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 microsoft/TypeScript

Todos los issues de microsoft/TypeScript

Issues similares

Más issues de Go

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.