Package Exports

js-precision
js-precision/js_precision.js
js-precision/js_precision_bg.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (js-precision) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

js-precision

🧮 wasm-precision

一个基于 Rust + WebAssembly 的高精度计算库，封装了 rust_decimal 实现，支持链式调用、科学计数法和精度控制，适用于前端金融、加密等高精度场景。

🧬 初始化

import { Precise } from "js-precision";

// 使用示例
const result = new Precise("0.1")
  .add("0.2")
  .div("3")
  .with_precision(8)
  .to_fixed(); // => "0.10000000"

console.log(result.value); // 高精度保留结果

创建实例

new Precise(value: string)

创建新的计算实例，支持字符串（包括科学计数法）

Precise.fromNumber(f64)

运算方法（链式）

.add(value: string)
.sub(value: string)
.mul(value: string)
.div(value: string)  // 自动避免除以 0

// 支持基本四则运算
// 所有参数均为字符串，支持科学计数法
// 返回新的 Precise 实例（可链式调用）

精度控制

.with_precision(n: number)

// 设置默认精度，用于 .to_fixed() 时保留的小数位数

值获取

.to_fixed(n?: number)
// 返回保留 n 位小数的字符串，若未传入 n，则使用 .with_precision 设置的默认值
.to_string()
// 返回不做四舍五入的原始字符串
.to_number()
// 转换为 JS 原生 Number 类型（可能有精度损失）
.to_json()
// 返回一个对象结构：
{
    value: string;      // 原始字符串值
    fixed: string;      // 保留小数位后的字符串值
    number: number;     // JS 原生 Number
    precision: number;  // 当前默认精度
}

示例输出

const p = new Precise("1e-7").mul("3").div("2");

console.log(p.to_fixed(12)); // "0.000000150000"
console.log(p.to_json());

{
  "value": "0.00000015",
  "fixed": "0.000000150000",
  "number": 1.5e-7,
  "precision": 12
}