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

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

Ouverte Adaptée aux débutants
#1,275 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
HTML
Étoiles
10.8k
Forks
1.2k
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

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

```javascript
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`。

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

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par le chapitre « Constructors and the new operator » à l’adresse https://zh.javascript.info/constructor-new et repérez sa source ainsi que sa section de résumé. Ajoutez une brève notice abordant l’avertissement de l’éditeur, la différence liée à l’absence de new entre les fonctions constructeurs et les classes, ainsi que le chapitre Class ultérieur ; le travail sera terminé lorsque les indications seront exactes, claires et cohérentes avec le style existant du tutoriel.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
javascript
Domaine
documentation
Type d'issue
Documentation
Difficulté
2/5
Temps estimé
1-3 heures
Activité
Calme
Clarté
Plutôt claire
Accessibilité débutants
68/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.