Skip to content

ffi: accept safe integer numbers for 64-bit arguments #66197

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nodejs-github-bot merged 3 commits into from
Oct 3, 2026
Merged

ffi: accept safe integer numbers for 64-bit arguments #66197

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
7153f93
ffi: accept safe integer numbers for 64-bit arguments
HoonDongKang Sep 28, 2026
3799107
doc: clarify accepted number values for 64-bit FFI argumentents
HoonDongKang Sep 28, 2026
079591f
ffi: combine fast integer validation and conversion
HoonDongKang Sep 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
doc: clarify accepted number values for 64-bit FFI argumentents 
Signed-off-by: HoonDongKang <d159123@naver.com>
Assisted-by: Codex:Astra-medium
  • Loading branch information
@HoonDongKang
HoonDongKang committed Sep 30, 2026
commit 3799107407bb31ef9c4e205a66eeb6b70429fc98
11 changes: 10 additions & 1 deletion doc/api/ffi.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -540,7 +540,16 @@ For 8-, 16-, and 32-bit integer types and for floating-point types, pass
JavaScript `number` values that match the declared type.

For 64-bit integer types (`int64` and `uint64`), pass JavaScript `bigint`
values.
values within the declared type's range or safe integer `number` values.
For `int64`, numbers must be between `Number.MIN_SAFE_INTEGER` and
`Number.MAX_SAFE_INTEGER`, inclusive. For `uint64`, numbers must be between
`0` and `Number.MAX_SAFE_INTEGER`, inclusive. This allows buffer lengths such
as `buffer.byteLength` to be passed without an explicit `BigInt()` conversion.
Use `bigint` for integers outside JavaScript's safe integer range.

Invalid arguments, including fractional numbers, `NaN`, infinities, and values
outside these ranges, throw `ERR_INVALID_ARG_VALUE`. Return values for 64-bit
integer types are always exposed as `bigint` values.

For pointer-like arguments:

Expand Down