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

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

Offen Anfängerfreundlich
#1,275 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Vorherrschende Sprache
HTML
Sterne
10.8k
Forks
1.2k
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

我在学习“构造函数和 '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

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

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne mit dem Kapitel „Constructors and the new operator“ unter https://zh.javascript.info/constructor-new und finde dort die Quell- und den Zusammenfassungsabschnitt. Füge einen kurzen Hinweis hinzu, der die Warnung des Editors, den Unterschied bezüglich des fehlenden new zwischen Konstruktorfunktionen und Klassen sowie das spätere Kapitel Class behandelt. Die Aufgabe ist abgeschlossen, wenn die Hinweise korrekt, klar und mit dem bestehenden Stil des Tutorials konsistent sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
javascript
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
68/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.