javascript-tutorial / javascript-tutorial/zh.javascript.info

[Suggestion] 建议在“构造函数和 "new" 运算符”章节末尾增加与现代 ES6 Class 的对比/过渡说明

Abierto Apto para principiantes
#1,275 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
HTML
Estrellas
10.8k
Forks
1.2k
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

我在学习“构造函数和 'new' 运算符”这一章节时,在现代编辑器(如 Zed)中尝试编写了页面中的示例代码:

function User(name) {
  this.name = name;
  this.isAdmin = false;
}
let user = new User("Jack");

此时编辑器(内置的 TypeScript/JavaScript 语言服务)会弹出一个非常显眼的重构提示:

"This constructor function may be converted to a class declaration."

对于初学者来说,看到这个提示可能会产生困惑(“既然教程教我用构造函数,为什么现代工具极力推荐我换成 class?”)。

Suggested Improvement

为了让教程更具现代前瞻性,并完美衔接后续的 “Class” 章节,建议在本章末尾(例如在“总结”之前)增加一个小提示(Notice/Sidebar),简要说明:

  1. 为什么现代工具会给出这个提示: 解释这是因为 ES6 引入了 class,它是构造函数的更安全的现代语法糖。
  2. 核心区别(防错机制): 简述构造函数漏写 new 会隐式失败(或污染全局),而 class 漏写 new 会直接抛出 TypeError,这也是 Linter/IDE 推荐重构的核心原因。
  3. 引导: 告诉读者现在可以继续学习构造函数以理解底层,后面会有专门的章节介绍 class

这样可以及时解答读者在实际敲代码时遇到的编辑器警告,让教程与现代开发工具的反馈更加契合。

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

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.

Línea de trabajo

Comienza con el capítulo «Constructors and the new operator» en https://zh.javascript.info/constructor-new y localiza allí su fuente y la sección de resumen. Añade una breve nota que aborde la advertencia del editor, la diferencia relacionada con la ausencia de new entre las funciones constructoras y las clases, y el capítulo posterior Class; estará terminado cuando la orientación sea precisa, clara y coherente con el estilo existente del tutorial.

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

Evaluación

Stack tecnológico
javascript
Área
documentation
Tipo de issue
Documentación
Dificultad
2/5
Tiempo estimado
1-3 horas
Estado de actividad
Tranquilo
Claridad
Bastante claro
Aptitud para principiantes
68/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.