René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Support `Temporal` across Node.js APIs","articleBody":"The [`Temporal` proposal](https://github.com/tc39/proposal-temporal) is currently Stage 3, has `in progress / experimental` implementation in V8 (available in latest releases using `--harmony-temporal`), and is likely to be unflagged in Node.js once it's stable enough (refs: https://github.com/nodejs/node/issues/57127, https://github.com/nodejs/node/pull/57128).\n\nIn light of this, I propose that Node.js begins supporting `Temporal` in the relevant APIs (mainly those that already work with `Date`s) after it becomes available by default without runtime flag.\n\nRelevant APIs:\n- [x] `fs`: `Stats` and `BigIntStats`\n  Only bigint version provides nanosecond precision, and both provide lazy getters for `Date` instances. Adding lazy getters for `Temporal.Instant` would also make non-bigint version provide nanosecond precision.\n- [ ] `fs`: `utimes()`, `lutimes()`, `futimes()`, `utimesSync()`, `lutimesSync()`, `futimesSync()`, `promises.utimes()`, `promises.lutimes()`, `filehandle.utimes()`\n  Accepts `atime` and `mtime` as `number`|`string`|`Date`, can support `Temporal.Instant` as well.\n  Note: these functions also don't accept `bigint`s yet. In the Temporal API, `number`s are used for `epochTime`s in milliseconds while `bigint`s are used for nanoseconds. Adding direct support of `bigint`s might result a confusing API: some users might expect it to coerce type and behave exactly the same as `number`|`string`, some might expect it to be parsed as nanoseconds. Adding `Temporal` support would make it unambiguous.\n\nMaybe there are other APIs that can benefit from this, too?\ncc @nodejs/fs since it's only https://github.com/nodejs/node/labels/fs at the moment.\n\nInternal updates (if it happens to be more precise, more fast, or more readable), generic support (primordials, `util`, `assert`, etc.) and dependencies (for example, `undici.setCookie(, { expires })`) are out of scope here.","author":{"url":"https://github.com/LiviaMedeiros","@type":"Person","name":"LiviaMedeiros"},"datePublished":"2025-04-15T14:16:01.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":6},"url":"https://github.com/57891/node/issues/57891"}