Support exporting structs as a reference

Offen

#737 erstellt am 01.5.2026 9 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 5/5
Geschätzter Aufwand: Über eine Woche
Anfängerfreundlichkeit: 45/100

Issue-Typ: Feature
Klarheit: Größtenteils klar
Aktivitätsstatus: Ruhig
Tech-Stack: javascript, swift
Bereich: api, web-dev

Rechercherichtung

Beginne damit, den aktuellen Struct-Export-Mechanismus und den generierten Code nachzuverfolgen, der verwendet wird, wenn Strukturen die Swift–JavaScript-Grenze überschreiten. Vergleiche dieses Verhalten mit der vorgeschlagenen Form @JS(boxed: true) und Issue #736 und überprüfe anschließend, dass boxed structs das beabsichtigte pointerbasierte Verhalten beibehalten, ohne ihre Inhalte zu kopieren.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

The current mechanism for exporting structs works great for simple structs, like @JS struct Point { let x: Double; let y: Double }. When passed out or into Swift, all the members of the struct are copied.

However, it is also common in Swift to have a less trivial struct, for example:

@JS struct Polygon {

    var vertices: [Point]

}

A complex polygon could have tens of thousands of vertices. This works fine in Swift, since the Array is COW. However, this is less than ideal when interoperating with JavaScript, where all the vertices would have to be copied every time the struct crosses the boundary.

Mutating functions currently don’t work on structs, but if they were working, this would also require copying the whole contents of the struct after each call. For example, a mutating addVertex function on Polygon would require copying every vertex across the boundary.

To workaround this issue, you could convert the struct into a class. This improves interoperability with JavaScript, however it can make Swift code less idiomatic.

Proposed Solution

A solution would be allowing structs to be exported using a heap allocated box, which could be expressed using @JS(boxed: true). A “boxed” struct would lead to very similar generated code to a class, where JavaScript just has a Swift-owned pointer.

Vorherrschende Sprache: Swift
Sterne: 986
Forks: 76
Ø Merge: 21 Std. 11 Min.
Gemergte PRs (30 T.): 4

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 swiftwasm/JavaScriptKit

BridgeJS: Add diagnostics for unsupported `from: .global` / `from: .module(...)` parameters for imported symbols Offen

Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 55/100

swiftwasm/JavaScriptKit#793 · Erstellt am 23.7.2026
BridgeJS: Same-named `@JS` types across modules collide silently in generated glue Offen

swiftwasm/JavaScriptKit#785 · 1 zugewiesene Person · Erstellt am 06.7.2026
[SwiftBuild] Preserve duplicate archive members when SwiftBuild expands static archives for linking Offen

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

swiftwasm/JavaScriptKit#781 · 3 Kommentare · Erstellt am 23.6.2026
☂️ `--build-system swiftbuild` compatibility issues Offen

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

swiftwasm/JavaScriptKit#773 · Erstellt am 23.6.2026
BridgeJS: Remove JSException storage boxing once swiftlang/swift#89715 lands Offen

swiftwasm/JavaScriptKit#767 · 1 zugewiesene Person · Erstellt am 11.6.2026

Alle Issues in swiftwasm/JavaScriptKit