#binding-generator #futures #bindgen #javascript #bridge #gap #promises #conversion #js #future

wasm-bindgen-futures

Bridging the gap between Rust Futures and JavaScript Promises

69 releases

0.4.34 Feb 1, 2023
0.4.33 Sep 12, 2022
0.4.32 Jul 25, 2022
0.4.29 Jan 19, 2022
0.3.5 Nov 12, 2018

#177 in WebAssembly

Download history 261241/week @ 2022-12-04 261926/week @ 2022-12-11 244067/week @ 2022-12-18 159092/week @ 2022-12-25 228388/week @ 2023-01-01 271816/week @ 2023-01-08 259621/week @ 2023-01-15 264375/week @ 2023-01-22 292296/week @ 2023-01-29 298162/week @ 2023-02-05 301331/week @ 2023-02-12 302028/week @ 2023-02-19 308174/week @ 2023-02-26 349271/week @ 2023-03-05 321391/week @ 2023-03-12 333515/week @ 2023-03-19

1,338,515 downloads per month
Used in 9,206 crates (413 directly)

MIT/Apache

2MB
38K SLoC

wasm-bindgen-futures

API Documention

This crate bridges the gap between a Rust Future and a JavaScript Promise. It provides two conversions:

  1. From a JavaScript Promise into a Rust Future.
  2. From a Rust Future into a JavaScript Promise.

Additionally under the feature flag futures-core-03-stream there is experimental support for AsyncIterator to Stream conversion.

See the API documentation for more info.


lib.rs:

Converting between JavaScript Promises to Rust Futures.

This crate provides a bridge for working with JavaScript Promise types as a Rust Future, and similarly contains utilities to turn a rust Future into a JavaScript Promise. This can be useful when working with asynchronous or otherwise blocking work in Rust (wasm), and provides the ability to interoperate with JavaScript events and JavaScript I/O primitives.

There are three main interfaces in this crate currently:

  1. JsFuture

    A type that is constructed with a Promise and can then be used as a Future<Output = Result<JsValue, JsValue>>. This Rust future will resolve or reject with the value coming out of the Promise.

  2. future_to_promise

    Converts a Rust Future<Output = Result<JsValue, JsValue>> into a JavaScript Promise. The future's result will translate to either a resolved or rejected Promise in JavaScript.

  3. spawn_local

    Spawns a Future<Output = ()> on the current thread. This is the best way to run a Future in Rust without sending it to JavaScript.

These three items should provide enough of a bridge to interoperate the two systems and make sure that Rust/JavaScript can work together with asynchronous and I/O work.

Dependencies

~1–1.6MB
~34K SLoC