#Val

A handle to a JS value, valid only within the current call.

pub fn show(env: napi.Env, value: napi.Val) !napi.Val {
    if (try value.isArray(env)) {
        const len = try value.getArrayLength(env);
        return env.toJs(len);
    }
    return env.toJs("not an array");
}

Val is extern struct so a []const Val is castable to [*]const napi_value for direct N-API calls.

#Conversion

#Type checks

#Property access

#Array access

#String access

#BigInt access

The auto-conversion path for i54..i64 and u54..u64 throws a RangeError when the source BigInt does not fit. To inspect the lossless flag yourself, take a napi.Val and use these methods:

pub fn clamp(env: napi.Env, v: napi.Val) !i64 {
    const r = try v.getBigIntI64(env);
    if (r.lossless) return r.value;
    return if (r.value > 0) std.math.maxInt(i64) else std.math.minInt(i64);
}

#Buffer access

#External and Date