rustwasm / wasm-bindgen

Facilitating high-level interactions between Wasm modules and JavaScript
https://rustwasm.github.io/docs/wasm-bindgen/
Apache License 2.0
7.84k stars 1.08k forks source link

Added more documentation for `bool`, `char`, and numeric types #4245

Closed RunDevelopment closed 2 weeks ago

RunDevelopment commented 3 weeks ago

A small PR where I added documentation for bool, char, and the numeric types to explain how they are represented in JS and how the conversion between JS values and Rust values works. I also added some links and formatting to a few other pages.

My goal was to answer all the questions I had about number conversions when I first used WBG. E.g. when I first used WBG, I thought that u64 would map to a JS number as well, since that's what the docs said: "JavaScript representation: A JavaScript number value". So I used js_sys::BigInt for the u64 in my project since I needed the full 64 bits and added some custom parsing logic to convert js_sys::BigInt -> u64. Clunky and unnecessary.


Relates to #4222 and #4201, since both PRs need to update the docs from this PR.

This PR is technically independent of #4226, but I can combine the two if you like.