docs: suggest adding performance comparison table for fs.promises vs callback API

Offen

#65,930 erstellt am 09.9.2026 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 3/5
Geschätzter Aufwand: 1-2 Tage
Anfängerfreundlichkeit: 68/100

Issue-Typ: Dokumentation
Klarheit: Größtenteils klar
Aktivitätsstatus: Aktiv
Tech-Stack: node.js
Bereich: documentation

Rechercherichtung

Beginne mit der Dokumentation des fs-Moduls und den dort vorhandenen Beschreibungen der promises- und callback-APIs. Recherchiere oder verifiziere die angeforderten Hinweise zu Performance bei hoher Nebenläufigkeit, Speichernutzung und zur Auswahl des Callbacks, bevor du den Vergleich hinzufügst. Als erledigt gilt die Aufgabe, wenn die Dokumentation alle drei Punkte klar abdeckt, ohne nicht belegte Unterschiede zu übertreiben.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

建议

在 fs 模块文档中添加一个性能对比说明，解释 fs.promises API 与传统 callback API 在性能上的差异和适用场景。

背景

很多开发者在选择文件系统 API 时不清楚 promises 和 callback 版本的性能差异。添加以下内容会很有帮助：

高并发场景下的性能表现差异
内存使用对比
何时应该使用 callback 版本以获得最佳性能

这对于构建高吞吐量的 Node.js 应用很有参考价值。

Vorherrschende Sprache: JavaScript
Sterne: 122k
Forks: 37.4k
Ø Merge: 4 T. 3 Std.
Gemergte PRs (30 T.): 279

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus nodejs/node

Stream.prototype.forEach will block in first promise in queue before read more chunk Offen

doc

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100

nodejs/node#66106 · Erstellt am 18.9.2026
nodejs 26.8.2 fails to build with clang/LLVM Offen

build

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 88/100

nodejs/node#66076 · 2 Kommentare · Erstellt am 17.9.2026
`TextEncoder.encodeInto()` underfills the destination for some non-ASCII text Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100

nodejs/node#65994 · 2 Kommentare · 2 Reaktionen · Erstellt am 11.9.2026
worker: `messageerror` listeners remain during `exit` Offen

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 90/100

nodejs/node#65782 · Erstellt am 04.9.2026
[`util.styleText`] Allow `text` param to be any scalar value (ex. `number`, `bool` etc additionaly to `string`) which will be casted internally to `string` Offen

feature request

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

nodejs/node#63841 · 1 Kommentar · Erstellt am 10.6.2026

Alle Issues in nodejs/node