數字：u8、i8、u16、i16、u32、i32、u64、i64、u128、i128、isize、usize、f32 和 f64

JavaScript 的 Number 底層是 64 位元浮點數值，無法精確表示 Rust 的所有數值型別。wasm-bindgen 將自動使用 BigInt 或 Number 在 JavaScript 中精確表示 Rust 的數值型別

• u8、i8、u16、i16、u32、i32、isize、usize、f32 和 f64 將在 JavaScript 中表示為 Number。
• u64、i64、u128 和 i128 將在 JavaScript 中表示為 BigInt。

注意：Wasm 目前是 32 位元架構，因此 isize 和 usize 是 32 位元整數，並且「符合」 JavaScript 的 Number。

注意：u128 和 i128 需要 wasm-bindgen 版本 0.2.96 或更高版本。

從 JavaScript 轉換為 Rust

wasm-bindgen 將自動處理 JavaScript 數字轉換為 Rust 數值型別。轉換規則如下

Number 轉換為 u8、i8、u16、i16、u32、i32、isize 和 usize

如果 JavaScript 數字是 Infinity、-Infinity 或 NaN，則 Rust 值將為 0。否則，JavaScript 數字將向零捨去（請參閱 Math.trunc 或 f64::trunc）。如果捨去後的數字對於目標整數型別而言太大或太小，它將會環繞。

例如，如果目標型別是 i8，Rust 將針對以下輸入看到以下值

這與將 JavaScript 的 Number 指定給 JavaScript 中適當整數型別的 類型化陣列 的行為相同，即 new Uint8Array([value])[0]。

除了處理 Infinity 和 -Infinity 之外，這與 轉換 f64 為 Rust 中適當整數型別的行為相同，即 value_f64 as u32。

BigInt 轉換為 u64、i64、u128 和 i128

如果 JavaScript BigInt 對於目標整數型別而言太大或太小，它將會環繞。

這與將 JavaScript 的 BigInt 指定給 JavaScript 中 64 位元整數型別的 類型化陣列 的行為相同，即 new Int64Array([value])[0]。

Number 轉換為 f32

JavaScript Number 使用與 Rust 中轉換 f64 為 f32 相同的規則轉換為 Rust f32，即 value_f64 as f32。

這與 Math.fround 或將 JavaScript Number 指定給 JavaScript 中的 Float32Array 的行為相同，即 new Float32Array([value])[0]。

Number 轉換為 f64

由於 JavaScript 數字是 64 位元浮點數值，因此將 JavaScript 的 Number 轉換為 Rust 的 f64 並不會進行任何操作。

Rust 使用範例

#![allow(unused)]
fn main() {
use wasm_bindgen::prelude::*;

#[wasm_bindgen]
pub fn take_number_by_value(x: u32) {}

#[wasm_bindgen]
pub fn return_number() -> f64 {
    42.0
}

#[wasm_bindgen]
pub fn take_option_number(x: Option<u8>) {}

#[wasm_bindgen]
pub fn return_option_number() -> Option<i16> {
    Some(-300)
}
}

JavaScript 使用範例

import {
  take_number_by_value,
  return_number,
  take_option_number,
  return_option_number,
} from './guide_supported_types_examples';

take_number_by_value(42);

let x = return_number();
console.log(typeof x); // "number"

take_option_number(null);
take_option_number(undefined);
take_option_number(13);

let y = return_option_number();
if (y == null) {
  // ...
} else {
  console.log(typeof y); // "number"
}