mirror of
https://github.com/nodejs/node.git
synced 2025-05-14 00:00:38 +00:00

All API introduced in this PR are compliant with web [performance-timeline](https://w3c.github.io/performance-timeline) spec. "performance-timeline" is listed as supported web spec in the doc https://nodejs.org/docs/latest/api/perf_hooks.html#perf_hooks_performance_measurement_apis. Changes summary: 1. Add new supported wpt test subsets: user-timing and performance-timeline. 2. Add support for `Performance.getEntries`, `Performance.getEntriesByName` and `Performance.getEntriesByType` to synchronously fetch buffered performance entries. This means the user should invoke `Performance.clearMarks` and `Performance.clearMeasures` to clear buffered entries to prevent from those entries been kept alive forever. 3. Add support (again after https://github.com/nodejs/node/pull/37136) for `buffered` flags for `PerformanceObserver`. 3. Fixes `PerformanceMark` and `PerformanceMeasure` wpt compliance issues. 4. Only user-created performance entries will be buffered globally. This behavior should be compliant with https://w3c.github.io/timing-entrytypes-registry/#registry. With the new ability to fetch user-created performance entries synchronously, the issues raised in https://github.com/nodejs/diagnostics/issues/464#issuecomment-861920116 could also be fixed. PR-URL: https://github.com/nodejs/node/pull/39297 Reviewed-By: James M Snell <jasnell@gmail.com>
186 lines
3.9 KiB
JavaScript
186 lines
3.9 KiB
JavaScript
'use strict';
|
|
|
|
const {
|
|
ObjectDefineProperty,
|
|
ObjectDefineProperties,
|
|
ObjectSetPrototypeOf,
|
|
TypeError,
|
|
} = primordials;
|
|
|
|
const {
|
|
EventTarget,
|
|
} = require('internal/event_target');
|
|
|
|
const { now } = require('internal/perf/utils');
|
|
|
|
const {
|
|
mark,
|
|
measure,
|
|
clearMarkTimings,
|
|
} = require('internal/perf/usertiming');
|
|
const {
|
|
clearEntriesFromBuffer,
|
|
filterBufferMapByNameAndType,
|
|
} = require('internal/perf/observe');
|
|
|
|
const eventLoopUtilization = require('internal/perf/event_loop_utilization');
|
|
const nodeTiming = require('internal/perf/nodetiming');
|
|
const timerify = require('internal/perf/timerify');
|
|
const { customInspectSymbol: kInspect } = require('internal/util');
|
|
const { inspect } = require('util');
|
|
|
|
const {
|
|
getTimeOriginTimestamp
|
|
} = internalBinding('performance');
|
|
|
|
class Performance extends EventTarget {
|
|
constructor() {
|
|
// eslint-disable-next-line no-restricted-syntax
|
|
throw new TypeError('Illegal constructor');
|
|
}
|
|
|
|
[kInspect](depth, options) {
|
|
if (depth < 0) return this;
|
|
|
|
const opts = {
|
|
...options,
|
|
depth: options.depth == null ? null : options.depth - 1
|
|
};
|
|
|
|
return `Performance ${inspect({
|
|
nodeTiming: this.nodeTiming,
|
|
timeOrigin: this.timeOrigin,
|
|
}, opts)}`;
|
|
}
|
|
}
|
|
|
|
function toJSON() {
|
|
return {
|
|
nodeTiming: this.nodeTiming,
|
|
timeOrigin: this.timeOrigin,
|
|
eventLoopUtilization: this.eventLoopUtilization()
|
|
};
|
|
}
|
|
|
|
function clearMarks(name) {
|
|
if (name !== undefined) {
|
|
name = `${name}`;
|
|
}
|
|
clearMarkTimings(name);
|
|
clearEntriesFromBuffer('mark', name);
|
|
}
|
|
|
|
function clearMeasures(name) {
|
|
if (name !== undefined) {
|
|
name = `${name}`;
|
|
}
|
|
clearEntriesFromBuffer('measure', name);
|
|
}
|
|
|
|
function getEntries() {
|
|
return filterBufferMapByNameAndType();
|
|
}
|
|
|
|
function getEntriesByName(name) {
|
|
if (name !== undefined) {
|
|
name = `${name}`;
|
|
}
|
|
return filterBufferMapByNameAndType(name, undefined);
|
|
}
|
|
|
|
function getEntriesByType(type) {
|
|
if (type !== undefined) {
|
|
type = `${type}`;
|
|
}
|
|
return filterBufferMapByNameAndType(undefined, type);
|
|
}
|
|
|
|
class InternalPerformance extends EventTarget {}
|
|
InternalPerformance.prototype.constructor = Performance.prototype.constructor;
|
|
ObjectSetPrototypeOf(InternalPerformance.prototype, Performance.prototype);
|
|
|
|
ObjectDefineProperties(Performance.prototype, {
|
|
clearMarks: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: clearMarks,
|
|
},
|
|
clearMeasures: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: clearMeasures,
|
|
},
|
|
eventLoopUtilization: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: eventLoopUtilization,
|
|
},
|
|
getEntries: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: getEntries,
|
|
},
|
|
getEntriesByName: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: getEntriesByName,
|
|
},
|
|
getEntriesByType: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: getEntriesByType,
|
|
},
|
|
mark: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: mark,
|
|
},
|
|
measure: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: measure,
|
|
},
|
|
nodeTiming: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: nodeTiming,
|
|
},
|
|
now: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: now,
|
|
},
|
|
timerify: {
|
|
configurable: true,
|
|
enumerable: false,
|
|
value: timerify,
|
|
},
|
|
// This would be updated during pre-execution in case
|
|
// the process is launched from a snapshot.
|
|
// TODO(joyeecheung): we may want to warn about access to
|
|
// this during snapshot building.
|
|
timeOrigin: {
|
|
configurable: true,
|
|
enumerable: true,
|
|
value: getTimeOriginTimestamp(),
|
|
},
|
|
toJSON: {
|
|
configurable: true,
|
|
enumerable: true,
|
|
value: toJSON,
|
|
}
|
|
});
|
|
|
|
function refreshTimeOrigin() {
|
|
ObjectDefineProperty(Performance.prototype, 'timeOrigin', {
|
|
configurable: true,
|
|
enumerable: true,
|
|
value: getTimeOriginTimestamp(),
|
|
});
|
|
}
|
|
|
|
module.exports = {
|
|
InternalPerformance,
|
|
refreshTimeOrigin
|
|
};
|