The perf_hooks module provides precise performance timing APIs similar to browser Performance APIs. Here's how to use it.
Basic Timing#
Loading code block...
Performance Marks and Measures#
Loading code block...
PerformanceObserver#
Loading code block...
Timing Functions#
Loading code block...
HTTP Server Timing#
Loading code block...
Histogram for Statistics#
Loading code block...
Resource Timing#
Loading code block...
Custom Performance Entries#
Loading code block...
Performance Timeline#
Loading code block...
Profiling Middleware#
Loading code block...
Benchmark Utility#
Loading code block...
Best Practices#
Measurement:
✓ Use marks and measures
✓ Name entries descriptively
✓ Clear entries after collection
✓ Use PerformanceObserver for async
Accuracy:
✓ Warmup before benchmarking
✓ Multiple iterations
✓ Calculate percentiles
✓ Account for GC pauses
Production:
✓ Sample measurements
✓ Aggregate statistics
✓ Monitor percentiles (p95, p99)
✓ Set alerting thresholds
Avoid:
✗ Too many performance marks
✗ Forgetting to clear entries
✗ Blocking with analysis
✗ Ignoring outliers
Conclusion#
The perf_hooks module provides powerful tools for precise performance measurement in Node.js. Use marks and measures for timing code sections, PerformanceObserver for async monitoring, and histograms for statistical analysis. Implement timing middleware for HTTP servers and build benchmark utilities for comparing implementations. Remember to clear entries to prevent memory growth and sample in production to minimize overhead.