diff --git a/docs/sources/k6/next/examples/correlation-and-dynamic-data.md b/docs/sources/k6/next/examples/correlation-and-dynamic-data.md index 8f51909b58..416537fe96 100644 --- a/docs/sources/k6/next/examples/correlation-and-dynamic-data.md +++ b/docs/sources/k6/next/examples/correlation-and-dynamic-data.md @@ -3,7 +3,7 @@ title: 'Correlation and Dynamic Data' slug: '/correlation-and-dynamic-data' description: | Scripting examples on how to correlate dynamic data in your test script. Correlation is - often required when using the Chrome Extension or HAR converter to generate your test script. + often required when using the HAR converter to generate your test script. This is due to the fact that those tools will capture session IDs, CSRF tokens, VIEWSTATE, wpnonce, and other dynamic values from your specific session. weight: 04 @@ -12,7 +12,7 @@ weight: 04 # Correlation and Dynamic Data Scripting examples on how to correlate dynamic data in your test script. Correlation is often -required when using the Chrome Extension or HAR converter to generate your test script. This +required when using the HAR converter to generate your test script. This is because those tools will capture session IDs, CSRF tokens, VIEWSTATE, wpnonce, and other dynamic values from your specific session. These tokens typically expire very quickly. This is one of the most common things that users will script for when testing user journeys across diff --git a/docs/sources/k6/next/get-started/resources.md b/docs/sources/k6/next/get-started/resources.md index d28c69a457..8d8cf09c1b 100644 --- a/docs/sources/k6/next/get-started/resources.md +++ b/docs/sources/k6/next/get-started/resources.md @@ -41,6 +41,5 @@ If you want to run tests with high loads, you can deploy and host them on your i - [Kubernetes Operator](https://k6.io/blog/running-distributed-tests-on-k8s/). Distribute test execution across a Kubernetes cluster. - [xk6 extensions](https://grafana.com/docs/k6//extensions). Custom k6 binaries to support the tool you need. -- [The browser recorder](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder). Make test scripts from browser sessions. - [Use TypeScript in k6 scripts](https://grafana.com/docs/k6//using-k6/javascript-typescript-compatibility-mode/) - [Integrations](https://grafana.com/docs/k6//misc/integrations) diff --git a/docs/sources/k6/next/reference/integrations.md b/docs/sources/k6/next/reference/integrations.md index 29ff73037f..3b1bdb455e 100644 --- a/docs/sources/k6/next/reference/integrations.md +++ b/docs/sources/k6/next/reference/integrations.md @@ -12,7 +12,6 @@ weight: 01 Codeless tools to speed up the test creation. - [Test Builder](https://grafana.com/docs/k6//using-k6/test-authoring/test-builder) - Inspired by the Postman API Builder. Codeless UI tool to generate a k6 test quickly. -- [Browser Recorder](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder) - Record a user journey to create your k6 test. ## IDE extensions diff --git a/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/_index.md b/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/_index.md index 34845532e0..7e118fb8fb 100644 --- a/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/_index.md +++ b/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/_index.md @@ -12,9 +12,10 @@ You can use this recording to auto-generate your test logic. Testers commonly use recordings to avoid writing complex tests from scratch. For example, testing advanced scenarios on websites or mobile applications, such as end-to-end (E2E) tests with dozens or hundreds of requests. -k6 provides three tools that can directly convert a recording into k6 script: +k6 provides two tools that can convert a recording into a k6 script: + +- [Grafana k6 Studio](https://grafana.com/docs/k6//k6-studio) is an open-source desktop application designed to help you record browser interactions and generate k6 test scripts. -- [Browser recorder](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder) generates a k6 script from a browser session. - [HAR converter](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter) generates a k6 script from the requests included in a HAR file. ## Steps diff --git a/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder.md b/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder.md index e0dfc351c6..4f7f03913d 100644 --- a/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder.md +++ b/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder.md @@ -1,6 +1,6 @@ --- title: 'Using the browser recorder' -description: 'The browser recorder allows generating a k6 script based on a web session. It is available as extensions for Chrome and Firefox.' +description: 'The browser recorder allows generating a k6 script based on a web session.' weight: 01 --- @@ -8,13 +8,10 @@ weight: 01 {{< admonition type="caution" >}} -The Grafana k6 Browser Recorder extension is deprecated and will be removed in a future release. Use [k6 Studio](https://grafana.com/docs/k6-studio) to record network traffic. +The Grafana k6 Browser Recorder extension is deprecated. Use [k6 Studio](https://grafana.com/docs/k6-studio) to record network traffic. {{< /admonition >}} -The browser recorder lets you generate a k6 script based on a browser session. -It's available as an extension for [Chrome](https://chrome.google.com/webstore/detail/grafana-k6-browser-record/fbanjfonbcedhifbgikmjelkkckhhidl) and [Firefox](https://addons.mozilla.org/en-US/firefox/addon/grafana-k6-browser-recorder/). - ## Before you start Before you start, consider the following: diff --git a/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-devtools-recorder.md b/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-devtools-recorder.md deleted file mode 100644 index 900551fc25..0000000000 --- a/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-devtools-recorder.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: 'Using the k6 DevTools recorder' -description: 'The k6 DevTools recorder allows you to export k6 browser scripts from the recorder panel in Chrome DevTools.' -weight: 01 ---- - -# Using the k6 DevTools recorder - -{{< admonition type="caution" >}} - -The k6 DevTools recorder extension is deprecated and will be removed in a future release. - -{{< /admonition >}} - -The k6 DevTools recorder lets you record user journeys using Chrome DevTools and then export them as a k6 script. - -## Before you begin - -To ensure you have a useful test output: - -- Review the [Be sure to record realistically](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/#be-sure-to-record-realistically) and [Consider hybrid approach for load testing websites](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/#consider-hybrid-approach-for-load-testing-websites) sections on [Create tests from recordings](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/). -- Learn the basics of k6 browser tests with [Running browser tests](https://grafana.com/docs/k6//using-k6-browser/running-browser-tests/). - -{{< admonition type="note" >}} - -Using the DevTools recorder _doesn't require a Grafana Cloud account_. - -{{< /admonition >}} - -## Create a script from a recording - -1. Install the [k6 DevTools Recorder Chrome extension](https://chromewebstore.google.com/detail/k6-devtools-recorder/fkajbajcclbdgaoanencnhpfnigfipgc). -1. Record a session using the [Chrome DevTools Recorder](https://developer.chrome.com/docs/devtools/recorder). -1. [Export the user flow](https://developer.chrome.com/docs/devtools/recorder/reference#export-flows) and choose the k6 Browser option. -1. Edit your script as necessary. Depending on the [type of test](https://grafana.com/docs/k6//testing-guides/test-types/), you might need to change different aspects of the script. - Typical changes are for [load options](https://grafana.com/docs/k6//using-k6/k6-options) and to handle [correlation and dynamic data](https://grafana.com/docs/k6//examples/correlation-and-dynamic-data). -1. Run the test from the CLI or Grafana Cloud k6. Refer to [Running k6](https://grafana.com/docs/k6//get-started/running-k6) for more details. diff --git a/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter.md b/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter.md index 54f13e87e4..2a9a8ae00e 100644 --- a/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter.md +++ b/docs/sources/k6/next/using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter.md @@ -7,7 +7,6 @@ weight: 02 # Using the HAR converter The [har-to-k6 converter](https://github.com/k6io/har-to-k6) is a NodeJS tool that generates a k6 script based on the HTTP requests included in a [HAR file](). -It is an alternative to the [Browser recorder](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder). {{< admonition type="note" >}} diff --git a/docs/sources/k6/v1.3.x/examples/correlation-and-dynamic-data.md b/docs/sources/k6/v1.3.x/examples/correlation-and-dynamic-data.md index 8f51909b58..416537fe96 100644 --- a/docs/sources/k6/v1.3.x/examples/correlation-and-dynamic-data.md +++ b/docs/sources/k6/v1.3.x/examples/correlation-and-dynamic-data.md @@ -3,7 +3,7 @@ title: 'Correlation and Dynamic Data' slug: '/correlation-and-dynamic-data' description: | Scripting examples on how to correlate dynamic data in your test script. Correlation is - often required when using the Chrome Extension or HAR converter to generate your test script. + often required when using the HAR converter to generate your test script. This is due to the fact that those tools will capture session IDs, CSRF tokens, VIEWSTATE, wpnonce, and other dynamic values from your specific session. weight: 04 @@ -12,7 +12,7 @@ weight: 04 # Correlation and Dynamic Data Scripting examples on how to correlate dynamic data in your test script. Correlation is often -required when using the Chrome Extension or HAR converter to generate your test script. This +required when using the HAR converter to generate your test script. This is because those tools will capture session IDs, CSRF tokens, VIEWSTATE, wpnonce, and other dynamic values from your specific session. These tokens typically expire very quickly. This is one of the most common things that users will script for when testing user journeys across diff --git a/docs/sources/k6/v1.3.x/get-started/resources.md b/docs/sources/k6/v1.3.x/get-started/resources.md index d28c69a457..8d8cf09c1b 100644 --- a/docs/sources/k6/v1.3.x/get-started/resources.md +++ b/docs/sources/k6/v1.3.x/get-started/resources.md @@ -41,6 +41,5 @@ If you want to run tests with high loads, you can deploy and host them on your i - [Kubernetes Operator](https://k6.io/blog/running-distributed-tests-on-k8s/). Distribute test execution across a Kubernetes cluster. - [xk6 extensions](https://grafana.com/docs/k6//extensions). Custom k6 binaries to support the tool you need. -- [The browser recorder](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder). Make test scripts from browser sessions. - [Use TypeScript in k6 scripts](https://grafana.com/docs/k6//using-k6/javascript-typescript-compatibility-mode/) - [Integrations](https://grafana.com/docs/k6//misc/integrations) diff --git a/docs/sources/k6/v1.3.x/reference/integrations.md b/docs/sources/k6/v1.3.x/reference/integrations.md index 29ff73037f..3b1bdb455e 100644 --- a/docs/sources/k6/v1.3.x/reference/integrations.md +++ b/docs/sources/k6/v1.3.x/reference/integrations.md @@ -12,7 +12,6 @@ weight: 01 Codeless tools to speed up the test creation. - [Test Builder](https://grafana.com/docs/k6//using-k6/test-authoring/test-builder) - Inspired by the Postman API Builder. Codeless UI tool to generate a k6 test quickly. -- [Browser Recorder](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder) - Record a user journey to create your k6 test. ## IDE extensions diff --git a/docs/sources/k6/v1.3.x/testing-guides/load-testing-websites.md b/docs/sources/k6/v1.3.x/testing-guides/load-testing-websites.md index 52606846d2..689af3cc76 100644 --- a/docs/sources/k6/v1.3.x/testing-guides/load-testing-websites.md +++ b/docs/sources/k6/v1.3.x/testing-guides/load-testing-websites.md @@ -168,8 +168,6 @@ export function Homepage() { } ``` -[Recording browser traffic](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder) helps you prototype to test websites on the protocol level. - ### Browser-based load testing Browser-based load testing verifies the frontend performance of an application by simulating real users using a browser to access your website. diff --git a/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/_index.md b/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/_index.md index 34845532e0..7e118fb8fb 100644 --- a/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/_index.md +++ b/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/_index.md @@ -12,9 +12,10 @@ You can use this recording to auto-generate your test logic. Testers commonly use recordings to avoid writing complex tests from scratch. For example, testing advanced scenarios on websites or mobile applications, such as end-to-end (E2E) tests with dozens or hundreds of requests. -k6 provides three tools that can directly convert a recording into k6 script: +k6 provides two tools that can convert a recording into a k6 script: + +- [Grafana k6 Studio](https://grafana.com/docs/k6//k6-studio) is an open-source desktop application designed to help you record browser interactions and generate k6 test scripts. -- [Browser recorder](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder) generates a k6 script from a browser session. - [HAR converter](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter) generates a k6 script from the requests included in a HAR file. ## Steps diff --git a/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder.md b/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder.md index e0dfc351c6..4f7f03913d 100644 --- a/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder.md +++ b/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder.md @@ -1,6 +1,6 @@ --- title: 'Using the browser recorder' -description: 'The browser recorder allows generating a k6 script based on a web session. It is available as extensions for Chrome and Firefox.' +description: 'The browser recorder allows generating a k6 script based on a web session.' weight: 01 --- @@ -8,13 +8,10 @@ weight: 01 {{< admonition type="caution" >}} -The Grafana k6 Browser Recorder extension is deprecated and will be removed in a future release. Use [k6 Studio](https://grafana.com/docs/k6-studio) to record network traffic. +The Grafana k6 Browser Recorder extension is deprecated. Use [k6 Studio](https://grafana.com/docs/k6-studio) to record network traffic. {{< /admonition >}} -The browser recorder lets you generate a k6 script based on a browser session. -It's available as an extension for [Chrome](https://chrome.google.com/webstore/detail/grafana-k6-browser-record/fbanjfonbcedhifbgikmjelkkckhhidl) and [Firefox](https://addons.mozilla.org/en-US/firefox/addon/grafana-k6-browser-recorder/). - ## Before you start Before you start, consider the following: diff --git a/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-devtools-recorder.md b/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-devtools-recorder.md deleted file mode 100644 index 900551fc25..0000000000 --- a/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-devtools-recorder.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: 'Using the k6 DevTools recorder' -description: 'The k6 DevTools recorder allows you to export k6 browser scripts from the recorder panel in Chrome DevTools.' -weight: 01 ---- - -# Using the k6 DevTools recorder - -{{< admonition type="caution" >}} - -The k6 DevTools recorder extension is deprecated and will be removed in a future release. - -{{< /admonition >}} - -The k6 DevTools recorder lets you record user journeys using Chrome DevTools and then export them as a k6 script. - -## Before you begin - -To ensure you have a useful test output: - -- Review the [Be sure to record realistically](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/#be-sure-to-record-realistically) and [Consider hybrid approach for load testing websites](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/#consider-hybrid-approach-for-load-testing-websites) sections on [Create tests from recordings](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/). -- Learn the basics of k6 browser tests with [Running browser tests](https://grafana.com/docs/k6//using-k6-browser/running-browser-tests/). - -{{< admonition type="note" >}} - -Using the DevTools recorder _doesn't require a Grafana Cloud account_. - -{{< /admonition >}} - -## Create a script from a recording - -1. Install the [k6 DevTools Recorder Chrome extension](https://chromewebstore.google.com/detail/k6-devtools-recorder/fkajbajcclbdgaoanencnhpfnigfipgc). -1. Record a session using the [Chrome DevTools Recorder](https://developer.chrome.com/docs/devtools/recorder). -1. [Export the user flow](https://developer.chrome.com/docs/devtools/recorder/reference#export-flows) and choose the k6 Browser option. -1. Edit your script as necessary. Depending on the [type of test](https://grafana.com/docs/k6//testing-guides/test-types/), you might need to change different aspects of the script. - Typical changes are for [load options](https://grafana.com/docs/k6//using-k6/k6-options) and to handle [correlation and dynamic data](https://grafana.com/docs/k6//examples/correlation-and-dynamic-data). -1. Run the test from the CLI or Grafana Cloud k6. Refer to [Running k6](https://grafana.com/docs/k6//get-started/running-k6) for more details. diff --git a/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter.md b/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter.md index 54f13e87e4..2a9a8ae00e 100644 --- a/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter.md +++ b/docs/sources/k6/v1.3.x/using-k6/test-authoring/create-tests-from-recordings/using-the-har-converter.md @@ -7,7 +7,6 @@ weight: 02 # Using the HAR converter The [har-to-k6 converter](https://github.com/k6io/har-to-k6) is a NodeJS tool that generates a k6 script based on the HTTP requests included in a [HAR file](). -It is an alternative to the [Browser recorder](https://grafana.com/docs/k6//using-k6/test-authoring/create-tests-from-recordings/using-the-browser-recorder). {{< admonition type="note" >}}