web-vitals is a small JavaScript library for measuring Web Vitals metrics on real users, using the same method Chrome and other Google performance tools report. It helps developers monitor Core Web Vitals like CLS, INP, and LCP, and can optionally include attribution data for diagnosing and prioritizing performance issues.
Project status
- Actively maintained, with an upstream push on 2026-06-10 and recent published updates as late as 2026-05-28, indicating ongoing development.
- Update cadence appears active, with v5.2.0 on 2026-03-25 and v5.3.0 on 2026-05-28 (about 2 months between these two), rather than a long quiet period.
AI summary generated
Recent updates
v5.3.0
v5.3.0 removes the getFirstHiddenTime polyfill and improves INP attribution logic for deriving interaction targets. It also adjusts internal instance caching to avoid configuration objects being shared across multiple metric functions causing errors. No release notes were provided in the release_notes section, but CHANGELOG.md includes entries for these changes.
Breakingv5.2.0
This release introduces a new INP attribution option, includeProcessedEventEntries, and refactors several core scheduling and attribution code paths. It also changes some public TypeScript typing exports and tightens/adjusts internal event collection logic for INP and LCP attribution.
BreakingFeaturesv5.1.0
Release v5.1.0 was published on 2025-07-31, but no release notes were provided by the publisher. Because the notes are missing, there is no direct information available here about new features, fixes, breaking changes, or migration requirements.
v5.0.3
This release is a small patch bump to v5.0.3. The code change centers on whenIdleOrHidden, specifically adding cleanup of a visibilitychange event listener. README and package metadata were also updated to reference the v5 CDN artifacts.
v5.0.2
Release v5.0.2 contains a small change to the CLS attribution logic in src/attribution/onCLS.ts and updates the package version metadata. The code change adds additional safety checks to handle layout shift entries that may not have any sources.
v5.0.1
Release v5.0.1 contains a targeted fix for incorrect missing reporting on prerendered pages, specifically called out as fixing missing FCP and LCP. The code change shows an adjustment to how the library interprets the first hidden visibility-state relative to activationStart, and the accompanying tests indicate behavior changes that extend beyond only FCP/LCP.
v5.0.0
No publisher release notes were provided for v5.0.0. The diff for this release mainly updates version metadata, documentation (README and upgrade guide), and e2e tests (timing/idle handling for INP reporting). The only concrete API-impact details visible in the diff are in CHANGELOG.md entries marked as breaking.
v5.0.0-rc.2
Release v5.0.0-rc.2 is described as a republish of v5.0.0-rc.1 with no intended functional changes. The code diff mainly updates version metadata and npm publishing behavior for prerelease tags.
v5.0.0-rc.1
v5.0.0-rc.1 adds configurable “target” generation for metric attribution via a new `generateTarget` option, affecting CLS, LCP, and INP attribution logic. It also refactors the internal attribution pipelines by introducing manager classes (for INP, LCP, and layout shifts) and removing the prior shared interactions module, alongside several type changes in attribution objects.
BreakingFeaturesv4.2.4
Release v4.2.4 was published on 2024-10-22, but the publisher did not provide any release notes. No documented changes, fixes, or upgrade guidance are available in the provided data.
v5.0.0-rc.0
This release is tagged v5.0.0-rc.0, but no release notes were provided by the publisher. As a result, there is no documented information about new features, breaking changes, bug fixes, security or performance updates. If you plan to upgrade, you should review the actual diff between your current version and v5.0.0-rc.0 for API or behavioral changes, and verify compatibility in your test suite.