Skip to content

Commit a3b171a

Browse files
authored
docs: Update Readme (#242)
1 parent 273ac77 commit a3b171a

File tree

2 files changed

+9
-50
lines changed

2 files changed

+9
-50
lines changed

Diff for: CHANGELOG.md

+5
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,11 @@
44

55
RC. IN-PROGRESS
66

7+
* **feat** remove `enableNavigationTracking` and have the behavior as the default
8+
* **feat** `getRating` has been consolidated into `getVitalsScore`
9+
* **chore** rename `incrementUjNavigation` to `trackUJNavigation`
10+
* **chore** deprecate `startPaint` and `endPaint`
11+
712
## 8.4.0 (2023-2-3)
813

914
* **fix:** disable `requestIdleCallback` for CLS and INP reports (#212)

Diff for: README.md

+4-50
Original file line numberDiff line numberDiff line change
@@ -35,10 +35,10 @@ Perfume is a tiny, web performance monitoring library that reports field data ba
3535

3636
**Perfume** leverages the latest Performance APIs to collect **field data** that allows us to understand what real-world users are actually experiencing.
3737

38-
- Navigation Timing
38+
- [Navigation Timing](#navigation-timing)
3939
- Navigator Interface
40-
- Resource Timing
41-
- Element Timing
40+
- [Resource Timing](#resource-timing)
41+
- [Element Timing](#element-timing)
4242
- Service Worker Status
4343
- StorageManager interface
4444
- Time to First Byte ([TTFB](https://web.dev/ttfb/#what-is-a-good-ttfb-score))
@@ -48,7 +48,7 @@ Perfume is a tiny, web performance monitoring library that reports field data ba
4848
- Cumulative Layout Shift ([CLS](https://web.dev/cls/))
4949
- Interaction to Next Paint ([INP](https://web.dev/inp/))
5050
- Total Blocking Time ([TBT](https://web.dev/tbt/))
51-
- Navigation Total Blocking Time (NTBT)
51+
- Navigation Total Blocking Time ([NTBT](#navigation-total-blocking-time-ntbt))
5252

5353
<br />
5454
At <a href="https://www.coinbase.com/blog/performance-vitals-a-unified-scoring-system-to-guide-performance-health-and-prioritization">Coinbase</a>, we use Perfume.js to capture a high-level scoring system that is clear, trusted, and easy to understand.
@@ -203,52 +203,6 @@ Perfume helps expose some of the key metrics you might need.
203203
// Perfume.js: fp 1482.00 ms
204204
```
205205

206-
### First Contentful Paint ([FCP](https://medium.com/@zizzamia/first-contentful-paint-with-a-touch-of-perfume-js-cd11dfd2e18f))
207-
208-
**FCP** is the exact time taken for the browser to render the first bit of content from the DOM, which can be anything from an important image, text, or even the small SVG at the bottom of the page.
209-
210-
```javascript
211-
// Perfume.js: fcp 2029.00 ms
212-
```
213-
214-
### Largest Contentful Paint (LCP)
215-
216-
**LCP** is an important, user-centric metric for measuring perceived load speed because it marks the point in the page load timeline when the page's main content has likely loaded—a fast LCP helps reassure the user that the page is useful.
217-
218-
We end the Largest Contentful Paint measure at two points: when First Input Delay happen and when the page's lifecycle state changes to hidden.
219-
220-
```javascript
221-
// Perfume.js: lcp 2429.00 ms
222-
```
223-
224-
### First Input Delay (FID)
225-
226-
**FID** measures the time from when a user first interacts with your site (i.e. when they click a link, tap on a button) to the time when the browser is actually able to respond to that interaction.
227-
228-
```javascript
229-
// Perfume.js: fid 3.20 ms
230-
```
231-
232-
### Cumulative Layout Shift (CLS)
233-
234-
**CLS** is an important, user-centric metric for measuring visual stability because it helps quantify how often users experience unexpected layout shifts—a low CLS helps ensure that the page is delightful.
235-
236-
We end the Cumulative Layout Shift measure at two points: when First Input Delay happen and when the page's lifecycle state changes to hidden.
237-
238-
```javascript
239-
// Perfume.js: cls 0.13
240-
```
241-
242-
### Total Blocking Time (TBT)
243-
244-
**TBT** is an important, user-centric metric for measuring load responsiveness because it helps quantify the severity of how non-interactive a page is prior to it becoming reliably interactive—a low TBT helps ensure that the page is usable.
245-
246-
We end the Total Blocking Time measure 10 seconds after FID.
247-
248-
```javascript
249-
// Perfume.js: tbt 347.07 ms
250-
```
251-
252206
### Navigation Total Blocking Time (NTBT)
253207

254208
This metric measures the amount of time the application may be blocked from processing code during the 2s window after a user navigates from page A to page B. The NTBT metric is the summation of the blocking time of all long tasks in the 2s window after this method is invoked.

0 commit comments

Comments
 (0)