Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/k6/next/javascript-api/k6-browser/page/throttlecpu.md, or by sending Accept: text/markdown to https://grafana.com/docs/k6/next/javascript-api/k6-browser/page/throttlecpu/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
Menu
This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.
Open source
throttleCPU(cpuProfile)
Throttles the CPU in Chrome/Chromium to slow it down by the specified rate in cpuProfile.
| Parameter | Type | Default | Description |
|---|---|---|---|
| cpuProfile | CPUProfile | null | This is a mandatory parameter. |
| cpuProfile.rate | number | 1 | rate as a slowdown factor (1 is no throttle, 2 is 2x slowdown, etc). |
Returns
| Type | Description |
|---|---|
Promise<void> | A Promise that fulfills when the CPU has been throttled to the specified rate. |
Example
JavaScript
import { browser } from 'k6/browser';
export const options = {
scenarios: {
browser: {
executor: 'shared-iterations',
options: {
browser: {
type: 'chromium',
},
},
},
},
};
export default async function () {
const context = await browser.newContext();
const page = await context.newPage();
try {
await page.throttleCPU({ rate: 4 });
await page.goto('https://test.k6.io/', { waitUntil: 'networkidle' });
} finally {
await page.close();
}
}Was this page helpful?
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:
Video

Performance testing and observability in Grafana Cloud
Optimize user experiences with Grafana Cloud. Learn real-time insights, performance testing with k6, and continuous validation with Synthetic Monitoring.
Events

User-centered observability: load testing, real user monitoring, and synthetics
Learn how to use load testing, synthetic monitoring, and real user monitoring (RUM) to understand end users' experience of your apps. Watch on demand.
Choose a product
Viewing: next
Find another version
Scroll for more