feat(utils): measure utils #1211

BioPhoton · 2026-01-12T01:32:37Z

Related to #1197

Example of how it will get used in the profiler:

export class Profiler<T extends Record<string, ActionTrack>> {
 
constructor(options: ProfilerOptions<T>) {
    this.ctxOf = measureCtx(options);
  }

  measure<R>(event: string, work: () => R, options?: MeasureOptions): R {
    const { start, success, error } = this.ctxOf(event, options);
    start(); // <= start mark 📍

    try {
      const r = work();
      success(r); // <= end mark 📍 + measure ✅
      return r;
    } catch (error_) {
      error(error_); // <= end mark 📍 + measure ❌
      throw error_;
    }
  }

  async measureAsync<R>(
    event: string,
    work: () => Promise<R>,
    options?: MeasureOptions,
  ): Promise<R> {
    const { start, success, error } = this.ctxOf(event, options);
    start(); // <= start mark 📍
    try {
      const r = work();
      success(r); // <= end mark 📍 + measure ✅
      return await r;
    } catch (error_) {
      error(error_); // <= end mark 📍 + measure ❌
      throw error_;
    }
  }
}

const profiler = new Profiler({
      track: 'Global Track',
      properties: [['Global:Config', `Process ID ${process.pid}`]],
      color: 'primary-dark',
      error: (error: unknown) => ({
        properties: [['Global:Error', `Custom Error Info: ${String(error)}`]],
      }),
    });

    // Your code to profile 
    const codeToProfile = ({ fail }: { fail?: boolean } = {}) => {
      if (fail) {
        throw new Error('test error');
      }
      return 1;
    };


  profiler.measure('app-run', codeToProfile, {
      color: 'primary',
      properties: [['Runtime:Config', `Thread ID ${threadId}`]],
      success: (result: unknown) => ({
        properties: [['Runtime:Result', String(result)]],
      }),
      error: (error: unknown) => ({
        properties: [
          ['Runtime:Error', `Stack Trace: ${String((error as Error)?.stack)}`],
        ],
      }),
    } )

nx-cloud · 2026-01-12T01:33:58Z

View your CI Pipeline Execution ↗ for commit f641ae0

Command	Status	Duration	Result
`nx affected -t e2e-test --parallel=1`	✅ Succeeded	12m 45s	View ↗

☁️ Nx Cloud last updated this comment at 2026-01-14 05:00:36 UTC

pkg-pr-new · 2026-01-12T01:34:14Z

Open in StackBlitz

@code-pushup/ci

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/ci@1211

@code-pushup/cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/cli@1211

@code-pushup/core

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/core@1211

@code-pushup/create-cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/create-cli@1211

@code-pushup/models

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/models@1211

@code-pushup/nx-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/nx-plugin@1211

@code-pushup/axe-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/axe-plugin@1211

@code-pushup/coverage-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/coverage-plugin@1211

@code-pushup/eslint-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/eslint-plugin@1211

@code-pushup/js-packages-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/js-packages-plugin@1211

@code-pushup/jsdocs-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/jsdocs-plugin@1211

@code-pushup/lighthouse-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/lighthouse-plugin@1211

@code-pushup/typescript-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/typescript-plugin@1211

@code-pushup/utils

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/utils@1211

commit: f641ae0

github-actions · 2026-01-12T02:23:50Z

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit e09ca57 with previous commit 7d3681c.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Performance	🔴 37	🔴 35
Documentation	🔴 34	🔴 34
Code coverage	🟢 91	🟢 91
Bug prevention	🟡 75	🟡 75
Axe Accessibility	🟡 88	🟡 88
Code style	🟢 99	🟢 99	–
Security	🟡 51	🟡 51	–
Updates	🟡 78	🟡 78	–
Type Safety	🟡 67	🟡 67	–
Miscellaneous	🟡 67	🟡 67	–
Accessibility	🟢 92	🟢 92	–
Best Practices	🟢 100	🟢 100	–
SEO	🟢 92	🟢 92	–

👍 2 groups improved, 👎 1 group regressed, 👍 7 audits improved, 👎 5 audits regressed, 13 audits changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score
Lighthouse	Performance	🔴 37	🔴 35
JSDocs coverage	Documentation coverage	🔴 34	🔴 34
Code coverage	Code coverage metrics	🟢 91	🟢 91

31 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value
Lighthouse	Initial server response time was short	🟩 Root document took 400 ms	🟥 Root document took 710 ms
Lighthouse	Speed Index	🟥 5.9 s	🟥 6.5 s
Lighthouse	First Contentful Paint	🟥 3.0 s	🟥 3.4 s
JSDocs coverage	Types coverage	🟥 260 undocumented types	🟥 265 undocumented types
JSDocs coverage	Functions coverage	🟥 597 undocumented functions	🟥 591 undocumented functions
Lighthouse	Max Potential First Input Delay	🟥 1,040 ms	🟥 820 ms
Lighthouse	Time to Interactive	🟥 13.0 s	🟥 13.5 s
Lighthouse	Total Blocking Time	🟥 1,990 ms	🟥 1,860 ms
Code coverage	Line coverage	🟨 86.2 %	🟨 86.4 %
Code coverage	Function coverage	🟩 93.4 %	🟩 93.5 %
JSDocs coverage	Variables coverage	🟥 271 undocumented variables	🟥 275 undocumented variables
Code coverage	Branch coverage	🟨 87.3 %	🟨 87.3 %
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,113 KiB	🟩 Total size was 2,168 KiB
Lighthouse	Server Backend Latencies	🟩 1,050 ms	🟩 350 ms
Lighthouse	JavaScript execution time	🟥 4.4 s	🟥 3.9 s
Lighthouse	Minimizes main-thread work	🟥 8.9 s	🟥 8.4 s
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Largest Contentful Paint	🟥 11.4 s	🟥 11.6 s
Lighthouse	Reduce unused CSS	🟥 Potential savings of 95 KiB	🟥 Potential savings of 95 KiB
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 200 KiB	🟥 Potential savings of 252 KiB
Lighthouse	Network Round Trip Times	🟩 0 ms	🟩 50 ms
Lighthouse	Uses efficient cache policy on static assets	🟨 31 resources found	🟨 31 resources found
Lighthouse	Remove duplicate modules in JavaScript bundles	🟥 Potential savings of 103 KiB	🟥 Potential savings of 110 KiB
JS packages	Outdated npm dev dependencies.	🟨 55 outdated package versions (29 major, 19 minor, 7 patch)	🟨 56 outdated package versions (29 major, 19 minor, 8 patch)
JSDocs coverage	Properties coverage	🟥 24 undocumented properties	🟥 23 undocumented properties

654 other audits are unchanged.

github-actions · 2026-01-12T02:38:06Z

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit e09ca57 with previous commit 7d3681c.

💼 Project `utils`

🤨 Code PushUp report has both improvements and regressions.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 36	🔴 37
Code coverage	🟢 94	🟢 95

4 other categories are unchanged.

👍 2 groups improved, 👍 4 audits improved, 👎 2 audits regressed, 1 audit changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDocs coverage	Documentation coverage	🔴 36	🔴 37
Code coverage	Code coverage metrics	🟢 94	🟢 95

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value
JSDocs coverage	Types coverage	🟥 59 undocumented types	🟥 64 undocumented types
JSDocs coverage	Functions coverage	🟥 246 undocumented functions	🟥 240 undocumented functions
Code coverage	Line coverage	🟩 93.8 %	🟩 94 %
JSDocs coverage	Variables coverage	🟥 43 undocumented variables	🟥 47 undocumented variables
Code coverage	Function coverage	🟩 95.8 %	🟩 96 %
Code coverage	Branch coverage	🟩 91.8 %	🟩 91.8 %
JSDocs coverage	Properties coverage	🟥 24 undocumented properties	🟥 23 undocumented properties

437 other audits are unchanged.

13 other projects are unchanged.

packages/utils/src/lib/user-timing-extensibility-api-utils.ts

matejchalk · 2026-01-14T15:10:25Z

packages/utils/src/lib/user-timing-extensibility-api-utils.ts

+ * cosnt {start, success, error} = apiMeasure('login');
+ *
+ * start();
+ * try {
+ *  cosnt result = myWork();
+ *  success(result);
+ *  return result;


🪡 A couple of typos and formatting inconsistencies:

Suggested change

* cosnt {start, success, error} = apiMeasure('login');

*

* start();

* try {

* cosnt result = myWork();

* success(result);

* return result;

* const { start, success, error } = apiMeasure('login');

*

* start();

* try {

* const result = myWork();

* success(result);

* return result;

matejchalk · 2026-01-14T15:10:40Z

packages/utils/src/lib/user-timing-extensibility-api-utils.ts

+ *   properties: [['action', 'save'], ['duration', 150]]
+ * });
+ * // { dataType: 'marker', color: 'primary', tooltipText: 'User action completed', ... }
+ * ```


🪡 You don't actually need to wrap the @example content into a code block; it's automatically formatted as a code block.

Suggested change

* ```

* @example

* const payload = markerPayload({

* color: 'primary',

* tooltipText: 'User action completed',

* properties: [['action', 'save'], ['duration', 150]]

* });

* // { dataType: 'marker', color: 'primary', tooltipText: 'User action completed', ... }

This applies to several JSDocs in this file.

John Doe added 2 commits January 12, 2026 01:28

fix: add measure utils

56b3cbe

fix: fix lint

4f1602b

github-actions bot assigned BioPhoton Jan 12, 2026

github-actions bot added 🔬 testing writing tests 🧩 utils labels Jan 12, 2026

BioPhoton mentioned this pull request Jan 12, 2026

Implement performance profiling and trace file generation #1197

Open

John Doe added 2 commits January 12, 2026 03:14

fix: unit tests

749cf54

fix: lint

e08c722

BioPhoton marked this pull request as ready for review January 12, 2026 02:45

BioPhoton requested a review from hanna-skryl January 12, 2026 18:12

hanna-skryl reviewed Jan 14, 2026

View reviewed changes

packages/utils/src/lib/user-timing-extensibility-api-utils.ts Show resolved Hide resolved

refactor: wip

f641ae0

BioPhoton requested review from hanna-skryl and matejchalk January 14, 2026 04:52

matejchalk reviewed Jan 14, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(utils): measure utils #1211

feat(utils): measure utils #1211

BioPhoton commented Jan 12, 2026 •

edited

Loading

Uh oh!

nx-cloud bot commented Jan 12, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Jan 12, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 12, 2026 •

edited

Loading

🗃️ Groups

🛡️ Audits

Uh oh!

github-actions bot commented Jan 12, 2026 •

edited

Loading

🗃️ Groups

🛡️ Audits

Uh oh!

Uh oh!

matejchalk Jan 14, 2026

Uh oh!

matejchalk Jan 14, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

- * ```
+ * @example
+ * const payload = markerPayload({
+ *   color: 'primary',
+ *   tooltipText: 'User action completed',
+ *   properties: [['action', 'save'], ['duration', 150]]
+ * });
+ * // { dataType: 'marker', color: 'primary', tooltipText: 'User action completed', ... }

feat(utils): measure utils #1211

Are you sure you want to change the base?

feat(utils): measure utils #1211

Conversation

BioPhoton commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nx-cloud bot commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new bot commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code PushUp

🏷️ Categories

🗃️ Groups

🛡️ Audits

Uh oh!

github-actions bot commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code PushUp

💼 Project utils

🗃️ Groups

🛡️ Audits

Uh oh!

Uh oh!

matejchalk Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

matejchalk Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

BioPhoton commented Jan 12, 2026 •

edited

Loading

nx-cloud bot commented Jan 12, 2026 •

edited

Loading

pkg-pr-new bot commented Jan 12, 2026 •

edited

Loading

github-actions bot commented Jan 12, 2026 •

edited

Loading

github-actions bot commented Jan 12, 2026 •

edited

Loading

💼 Project `utils`