Summary
new v8.GCProfiler() should expose a profiling object whose start() / stop() methods collect and return a GC profiler report. Perry currently has no public node:v8 GCProfiler implementation.
Node Behavior
A minimal Node probe shows the profiler shape:
const v8 = require("node:v8");
const profiler = new v8.GCProfiler();
console.log(typeof v8.GCProfiler, profiler.constructor.name);
console.log(typeof profiler.start, typeof profiler.stop);
console.log(profiler.start());
const result = profiler.stop();
console.log(Object.keys(result));
Observed on Node v25.9.0: GCProfiler is a constructor; instances expose function-valued start and stop; start() returns undefined; stop() returns an object with keys including version, startTime, statistics, and endTime.
Perry Behavior
docs/runtime-parity.md marks new GCProfiler() missing under node:v8. docs/runtime-parity-gaps.md tracks node:v8 as a whole-module gap, source search found no public node:v8 GCProfiler implementation, and there is no dedicated V8 parity fixture in this checkout.
Suggested PR Cut
Batch this with related issues in:
#3296 - node:v8: snapshot and profiler output parity cut
Good batch candidates:
Do not batch with:
Acceptance
- A parity/regression test proves
new v8.GCProfiler() returns an object with function-valued start and stop.
start() returns undefined, and stop() returns an object with Node-compatible report keys for the covered case.
- The profiler data may reflect Perry internals or a minimal compatible report, but the constructor/method/report shape matches Node for package diagnostics.
- Related known-failure/docs/manifest entries are updated if touched.
Summary
new v8.GCProfiler()should expose a profiling object whosestart()/stop()methods collect and return a GC profiler report. Perry currently has no publicnode:v8GCProfiler implementation.Node Behavior
A minimal Node probe shows the profiler shape:
Observed on Node v25.9.0:
GCProfileris a constructor; instances expose function-valuedstartandstop;start()returnsundefined;stop()returns an object with keys includingversion,startTime,statistics, andendTime.Perry Behavior
docs/runtime-parity.mdmarksnew GCProfiler()missing undernode:v8.docs/runtime-parity-gaps.mdtracksnode:v8as a whole-module gap, source search found no publicnode:v8GCProfiler implementation, and there is no dedicated V8 parity fixture in this checkout.Suggested PR Cut
Batch this with related issues in:
#3296 -
node:v8: snapshot and profiler output parity cutGood batch candidates:
Do not batch with:
Acceptance
new v8.GCProfiler()returns an object with function-valuedstartandstop.start()returnsundefined, andstop()returns an object with Node-compatible report keys for the covered case.