Pause tracing

import { withTracingPaused } from "@intuned/runtime";

await withTracingPaused(async () => {
  await page.getByLabel("Password").fill(params.password);
  await page.getByRole("button", { name: "Sign in" }).click();
});

​

Available helpers

• withTracingPaused — Run a block of code with tracing paused
• pauseTracing — Pause tracing until it is resumed
• resumeTracing — Resume tracing

​

Function reference

​

withTracingPaused

import { withTracingPaused } from "@intuned/runtime";

function withTracingPaused<T>(callback: () => Promise<T>): Promise<T>;

import { withTracingPaused } from "@intuned/runtime";
import { TOTP } from "totp-generator";

const token = await withTracingPaused(async () => {
  const code = TOTP.generate(params.secret, { digits: 6 }).otp;
  await page.getByLabel("One-time Password").fill(code);
  await page.getByRole("button", { name: "Login" }).click();
  return code;
});

​

pauseTracing

import { pauseTracing } from "@intuned/runtime";

function pauseTracing(): void;

import { pauseTracing, resumeTracing } from "@intuned/runtime";

pauseTracing();
try {
  await page.getByLabel("SSN").fill(params.ssn);
} finally {
  resumeTracing();
}

​

resumeTracing

import { resumeTracing } from "@intuned/runtime";

function resumeTracing(): void;

​

What pausing covers

• Browser trace — No actions, DOM snapshots, or network requests are recorded. The trace viewer shows a gap.
• Screenshots — No screenshots are captured, including the ones taken automatically around actions.
• Automation logs — Anything your code writes to stdout or stderr is dropped rather than stored on the attempt.

• The Run and Attempt records themselves—status, timing, and retry history.
• Your automation’s return value, and the Run’s parameters. Tracing has no effect on either. To keep a value out of the Run record entirely, use ephemeral parameters.
• Errors. A thrown error’s message and stack trace are still stored on the attempt, even if it was thrown while tracing was paused.

​

Behavior notes

• Nesting works. Nested withTracingPaused blocks are safe; tracing resumes when the outermost block exits.
• Scope is the attempt. Tracing state resets at the start of every attempt, so a retry always begins with tracing active.
• Local development included. The helpers behave the same under intuned dev, so a locally captured trace has the same gaps a deployed one would.
• Ephemeral parameters pause automatically. getEphemeralParameter pauses tracing on your behalf before it returns a value.

​

Related

• Ephemeral parameters — Pass secrets to a Run without storing them.
• Monitoring and traces — How traces and attempt logs are captured and viewed.
• Intuned.json reference — saveTrace defaults for dev and deployed runs.