If you call std::time::Instant::now()
on a WASM platform, it will panic. This crate provides a partial
replacement for std::time::Instant
that works on WASM too. This defines the type instant::Instant
which is:
wasm32-unknown-unknown
or wasm32-unknown-asmjs
and you enabled either the stdweb
or the wasm-bindgen
feature. This emulation is based on the javascript performance.now()
function.std::time::Instant
otherwise.Note that even if the stdweb or wasm-bindgen feature is enabled, this crate will continue to rely on std::time::Instant
as long as you are not targeting wasm32. This allows for portable code that will work on both native and WASM platforms.
now
.By enabling the feature now
the function instant::now()
will be exported and will either:
performance.now()
when compiling for a WASM platform with the features stdweb or wasm-bindgen enabled.time::precise_time_s() * 1000.0
otherwise.The result is expressed in milliseconds.
instant
for a native platform.Cargo.toml:
toml
[dependencies]
instant = "0.1"
main.rs:
rust
fn main() {
// Will be the same as `std::time::Instant`.
let now = instant::Instant::new();
}
instant
for a WASM platform.This example shows the use of the stdweb
feature. It would be similar with wasm-bindgen
.
Cargo.toml:
toml
[dependencies]
instant = { version = "0.1", features = [ "stdweb" ] }
main.rs:
rust
fn main() {
// Will emulate `std::time::Instant` based on `performance.now()`.
let now = instant::Instant::new();
}
instant
for any platform enabling a feature transitively.Cargo.toml: ```toml [features] stdweb = [ "instant/stdweb" ] wasm-bindgen = [ "instant/wasm-bindgen" ]
[dependencies] instant = "0.1" ```
lib.rs:
rust
fn my_function() {
// Will select the proper implementation depending on the
// feature selected by the user.
let now = instant::Instant::new();
}
now
.Cargo.toml: ```toml [features] stdweb = [ "instant/stdweb" ] wasm-bindgen = [ "instant/wasm-bindgen" ]
[dependencies] instant = { version = "0.1", features = [ "now" ] } ```
lib.rs:
rust
fn my_function() {
// Will select the proper implementation depending on the
// feature selected by the user.
let now_instant = instant::Instant::new();
let now_milliseconds = instant::now(); // In milliseconds.
}