mirrors/bun.sh
1
0
Fork 0
mirror of https://github.com/oven-sh/bun synced 2026-02-09 10:28:47 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Updated Bun.nanoseconds documentation (#9986)

Browse Source
This commit is contained in:
Tomer Horowitz
2024-04-06 12:47:47 +03:00
committed by GitHub
parent c4847f464e
commit 0b0bf353fa
1 changed files with 11 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
packages/bun-types/bun.d.ts vendored
View File

@@ -2992,12 +2992,19 @@ declare module "bun" {
}
/**
* Nanoseconds since Bun.js was started as an integer.
* Returns the number of nanoseconds since the process was started.
*
* This uses a high-resolution monotonic system timer.
* This function uses a high-resolution monotonic system timer to provide precise time measurements.
* In JavaScript, numbers are represented as double-precision floating-point values (IEEE 754),
* which can safely represent integers up to 2^53 - 1 (Number.MAX_SAFE_INTEGER).
*
* After 14 weeks of consecutive uptime, this function
* wraps
* Due to this limitation, while the internal counter may continue beyond this point,
* the precision of the returned value will degrade after 14.8 weeks of uptime (when the nanosecond
* count exceeds Number.MAX_SAFE_INTEGER). Beyond this point, the function will continue to count but
* with reduced precision, which might affect time calculations and comparisons in long-running applications.
*
* @returns {number} The number of nanoseconds since the process was started, with precise values up to
* Number.MAX_SAFE_INTEGER.
*/
function nanoseconds(): number;