javascript-tutorial / javascript-tutorial/zh.javascript.info
[Suggestion] 建议在“构造函数和 "new" 运算符”章节末尾增加与现代 ES6 Class 的对比/过渡说明
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),简要说明:
- 为什么现代工具会给出这个提示: 解释这是因为 ES6 引入了
class,它是构造函数的更安全的现代语法糖。 - 核心区别(防错机制): 简述构造函数漏写
new会隐式失败(或污染全局),而class漏写new会直接抛出TypeError,这也是 Linter/IDE 推荐重构的核心原因。 - 引导: 告诉读者现在可以继续学习构造函数以理解底层,后面会有专门的章节介绍
class。
这样可以及时解答读者在实际敲代码时遇到的编辑器警告,让教程与现代开发工具的反馈更加契合。
Guía de contribución
No hay ninguna guía de contribución indexada para este repositorio
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
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