This release introduces a few enhancements and deprecations. Namely, JSValueConstructible and JSValueConvertible were renamed to ConstructibleFromJSValue and ConvertibleToJSValue respectively. The old names are deprecated, and you should move away from using the old names in your code. Additionally, JavaScriptKit now requires the most recent 5.3 and development toolchains, but thanks to this it no longer uses unsafe flags, which prevented building other libraries depending on JavaScriptKit on other platforms.
The main user-visible enhancement is that now force casts are no longer required in client code. That is, we now allow this
let document = JSObject.global.document
let foundDivs = document.getElementsByTagName("div")in addition to the previously available explicit style with force unwrapping:
let document = JSObject.global.document.object!
let foundDivs = document.getElementsByTagName!("div").object!Note that the code in the first example is still dynamically typed. The Swift compiler won't warn you if you misspell names of properties or cast them to a wrong type. This feature is purely additive, and is added for convenience. You can still use force unwraps in your code interfacing with JavaScriptKit. If you're interested in a statically-typed DOM API, we recommend having a look at the DOMKit library, which is currently in development.
Lastly, JSError now conforms to the JSBridgedClass protocol, which makes it easier to integrate with idiomatic Swift code.
Closed issues:
- Errors building example: undefined symbols (#95)
- Documentation website is broken (#93)
- Rename
JSValueConstructibleandJSValueConvertible(#87) - Build fails with the unsafe flags error (#6)
Merged pull requests:
- Update example code in
README.md(#100) via @MaxDesiatov - Update toolchain version, script, and
README.md(#96) via @MaxDesiatov - [Proposal] Add unsafe convenience methods for JSValue (#98) via @kateinoigakukun
- Remove all unsafe linker flags from Package.swift (#91) via @kateinoigakukun
- Sync package.json and package-lock.json (#90) via @kateinoigakukun
- Rename JSValueConvertible/Constructible/Codable (#88) via @j-f1
- Bump @actions/core from 1.2.2 to 1.2.6 in /ci/perf-tester (#89) via @dependabot[bot]
- Make
JSErrorconform toJSBridgedClass(#86) via @MaxDesiatov
Assets
2
This is a bugfix release that resolves an issue with the JavaScript runtime being unavailable when installed via NPM.
Assets
2
This is a bugfix release that resolves an issue with the JavaScript runtime being unavailable when installed via NPM.
Closed issues:
Merged pull requests:
- Fix runtime files location in
package.json(#81) via @MaxDesiatov - Run 4 perf tests instead of 2 (#80) via @j-f1
- Specify correct SwiftWasm snapshot in
README.md(#78) via @MaxDesiatov
Assets
2
This release adds multiple new types bridged from JavaScript, namely JSError, JSDate, JSTimer (which corresponds to setTimeout/setInterval calls and manages closure lifetime for you), JSString and JSPromise. We now also have documentation published automatically for the main branch.
Closed issues:
TypedArrayimprovement? (#52)
Merged pull requests:
- Add a generic
JSPromiseimplementation (#62) via @MaxDesiatov - Remove payload2 from value bridging interface (#64) via @kateinoigakukun
- Update Node.js dependencies (#65) via @MaxDesiatov
- Implement
JSStringto reduce bridging overhead (#63) via @kateinoigakukun - Add
JSBridgedTypeandJSBridgedClass(#26) via @j-f1 - Make
JSValueconform toExpressibleByNilLiteral(#59) via @j-f1 - Remove
JavaScriptTypedArrayKind(#58) via @j-f1 - Add doc comments for public APIs (Part 2) (#57) via @kateinoigakukun
- Add doc comments for public APIs (Part 1) (#55) via @kateinoigakukun
- Cleanup invalid test target (#53) via @kateinoigakukun
- Remove deprecated Ref suffix (#51) via @j-f1
- Rename
reftojsObjecton JSDate for consistency with JSError (#50) via @MaxDesiatov - Generate and publish documentation with
swift-doc(#49) via @MaxDesiatov - Add
JSTimerimplementation with tests (#46) via @MaxDesiatov - Add
JSError.stack, addErrorconformance (#48) via @MaxDesiatov - Add
JSDateimplementation with tests (#45) via @MaxDesiatov - Add
JSErrorwith tests, add JSObject.description (#47) via @MaxDesiatov
Assets
2
This release adds JSTypedArray generic type, renames JSObjectRef to JSObject, and makes JSClosure memory management more explicit.
Closed issues:
- Support for JS Arrays “holes”, including the test suite (#39)
- BigInt Support (#29)
- Separate namespaces for methods and properties? (#27)
Merged pull requests:
- Add a helper method to copy an array of numbers to a JS TypedArray (#31) via @j-f1
- Resolve small issues (#44) via @kateinoigakukun
- Bump bl from 3.0.0 to 3.0.1 in /IntegrationTests (#42) via @dependabot[bot]
- Bump bl from 3.0.0 to 3.0.1 in /Example (#43) via @dependabot[bot]
- Support Holes in Array (#41) via @kateinoigakukun
- Refine public API (#40) via @kateinoigakukun
- Fix invalid array termination for null and undefined (#38) via @kateinoigakukun
- Add a test helper function (#36) via @j-f1
- Enable Xcode 12 with fresh SwiftWasm 5.3 snapshot (#35) via @MaxDesiatov
- Add void-returning overload to
JSClosure.init(#34) via @MaxDesiatov - Change
JSClosure.releasetodeinit(#33) via @MaxDesiatov - Clean up the
JSObjectRefAPI (#28) via @j-f1 - Remove unused
Testsdirectory (#32) via @MaxDesiatov
Assets
2
Update package.json