Unify handling of string-like arguments across the API

Offen

#1,745 erstellt am 10.8.2026 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 4/5
Geschätzter Aufwand: 3-5 Tage
Anfängerfreundlichkeit: 55/100

Issue-Typ: Refactoring
Klarheit: Größtenteils klar
Aktivitätsstatus: Ruhig
Tech-Stack: cpp
Bereich: api

Rechercherichtung

Beginne damit, die Deklarationen und Implementierungen von String::New, Symbol::New und Symbol::For zu finden, und vergleiche anschließend deren bestehende std::string- und std::string_view-Überladungen. Erledigt ist die Aufgabe, wenn die redundanten Überladungen über das eingeschränkte string_view-ähnliche Template vereinheitlicht sind, während const char* und Literale ihre dedizierte Behandlung behalten und nullptr weiterhin ausgeschlossen bleibt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

SemVer-major

Follow-up to #1741 / #1742.

Several APIs still carry multiple overloads for different string types. Now that the library requires C++17, we can modernize by preferring std::string_view and removing the redundant UTF-8 overloads, replacing them with a single constrained template, as a semver-major change.

For String::New, Symbol::New, and Symbol::For, collapse the const std::string& + std::string_view pair into:

template <typename T,
          std::enable_if_t<
              std::is_convertible_v<const T&, std::string_view> &&
              !std::is_convertible_v<const T&, const char*>, int> = 0>
static String New(napi_env env, const T& t);

This matches the C++17 standard-library idiom (std::string's find/append/compare/… members). The !is_convertible_v<const T&, const char*> clause keeps const char* and literals on the dedicated overload and filters nullptr (avoiding a UB string_view(nullptr)).

The enable_if alias is shareable across APIs e.g. enable_if_string_view_like_t<T>.

Vorherrschende Sprache: C++
Sterne: 2.4k
Forks: 499
Ø Merge: 2 T. 11 Std.
Gemergte PRs (30 T.): 2

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-addon-api

Adopt C++20 defaulted comparisons (operator== / <=>) Offen

blocked SemVer-major

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 52/100

nodejs/node-addon-api#1748 · Erstellt am 10.8.2026
Support C++20 span types Offen

SemVer-major

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 55/100

nodejs/node-addon-api#1747 · 2 Kommentare · Erstellt am 10.8.2026
Enforce callback signatures with C++ Concepts Offen

blocked SemVer-major

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 52/100

nodejs/node-addon-api#1746 · Erstellt am 10.8.2026
`napi_adjust_external_memory` crashes when `NAPI_EXPERIMENTAL` is defined Offen

stale

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 48/100

nodejs/node-addon-api#1724 · 2 Kommentare · Erstellt am 13.4.2026
Supporting circular references that can be garbage collected. Offen

never-stale

Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 25/100

nodejs/node-addon-api#1665 · 5 Kommentare · Erstellt am 07.6.2025

Alle Issues in nodejs/node-addon-api