No Result Found
Connect & Get help from 6000+ developers on our Discord community. Ask the CommunityAsk the Community

Hybrid load testing using JMeter with Playwright

Run a hybrid load test using Playwright scripts on BrowserStack Load Testing

Prerequisites

  • BrowserStack Username and Access key. You can find this under your account profile.
  • An existing JMeter script and an automated test suite written in Playwright Javascript or Typescript.

Run a test

You can start a new test either from the Quick Start page, or the Load Tests page on the Load testing dashboard.

On the dashboard, click Create Load Test.

Screenshot of load testing dashboard showing the run a new test button highlighted

Enter a Test Name for your load test, select Hybrid and click Upload scripts

Dashboard showing test name field and type of load test to run

Upload your scripts

The product runs a hybrid test using JMeter and Playwright automation projects. JMeter is used to generate API-level load, and Playwright drives browser-level load to simulate real user interactions.

You see two sections:

  • JMeter Script: Upload your JMeter .jmx file (up to 50MB). Drag and drop the file or click to select it.
  • Automation Project: Select Playwright - NodeJS from the dropdown as your automation framework. Then, upload your zipped project files (.zip up to 250MB). Drag and drop the file or click to select it.

Screenshot of load testing dashboard asking to add scripts for load testing

Both fields are mandatory for their respective test types. After uploading, click Configure Load to proceed to the next step.

You can also run load tests using the sample scripts if you want to try out the feature before uploading your own files.

You can configure the following load parameters to customize your load test:

Run test

After you finish configuring load parameters, click RUN TEST

Download BrowserStack NodeJS SDK

Run the given command to install the BrowserStack NodeJS SDK in your project

Copy icon Copy

Initialize your project for Load Testing

Run the given command from the root directory of your test project to generate the browserstack-load.yml file which contains the configuration required to define and run your load test:

Copy icon Copy

Configure your Load Test

Open the generated browserstack-load.yml file and update it with the relevant test details. Here’s a sample configuration:

Specify the tests

  • The tests block defines the combination of test types you want to run as part of a hybrid load test. Specify Playwright as the testType for one sub-block and JMeter for another.
  • For the Playwright sub-block,
    • browserLoadPercent - Specify the percentage of total virtual users to be allocated for Playwright tests.
    • language - Set this to nodejs.
    • files - Define the key files needed to install dependencies and identify which tests to execute.
      • Under dependencies, include the path to files required for environment setup. For Node.js projects, this is typically package.json.
      • Under testConfigs, provide the path to your playwright.config.js.
  • For the JMeter sub-block,
    • apiLoadPercent - Specify the percentage of total virtual users to be allocated for JMeter tests.
    • testScripts - Set the path to the .jmx file.

Headless mode

  • You can configure your Playwright load tests to run in either headless or headful mode using the headless capability.
  • Headless mode (default): The browser runs without a visible UI, which is faster and consumes fewer resources. Most CI/CD and automated load tests use headless mode.
  • Headful mode: The browser UI remains visible during test execution.
  • If not specified, tests will run in headless mode by default.

Set reporting structure

Use projectName to group related tests under the same project on the dashboard. Use testName to group multiple runs of the same test.
Both projectName and testName must remain consistent across different runs of the same test.
You can use the following characters in projectName and testName:

  • Letters (A–Z, a–z)
  • Digits (0–9)
  • Periods (.), colons (:), hyphens (-), square brackets ([]), forward slashes (/), at signs (@), ampersands (&), single quotes ('), and underscores (_)
    All other characters are ignored.

You can configure the following load parameters to customize your load test:

browserstack-load.yml
Copy icon Copy

Run the Load Test

Run the given command to start your test:

Copy icon Copy

Check out the FAQs section to get answers to commonly asked questions.

View test results

Once the test starts running, you’ll get a link to the test report.

Prerequisites

  • BrowserStack Username and Access key. You can find this under your account profile.
  • An existing k6 script and an automated test suite written in Playwright Javascript or Typescript.

Run a test

You can start a new test either from the Quick Start page, or the Load Tests page on the Load testing dashboard.

On the dashboard, click Create Load Test.

Screenshot of load testing dashboard showing the run a new test button highlighted

Enter a Test Name for your load test, select Hybrid and click Upload scripts

Dashboard showing test name field and type of load test to run

Upload your scripts

The product runs a hybrid test using k6 and Playwright automation projects. k6 is used to generate API-level load, and Playwright drives browser-level load to simulate real user interactions.

You see two sections:

  • k6 Script: Upload your k6 .js file (up to 50MB). Drag and drop the file or click to select it.
  • Automation Project: Select Playwright - NodeJS from the dropdown as your automation framework. Then, upload your zipped project files (.zip up to 250MB). Drag and drop the file or click to select it.

Screenshot of load testing dashboard asking to add scripts for load testing

Both fields are mandatory for their respective test types. After uploading, click Configure Load to proceed to the next step.

You can also run load tests using the sample scripts if you want to try out the feature before uploading your own files.

You can configure the following load parameters to customize your load test:

Run test

After you finish configuring load parameters, click RUN TEST

Download BrowserStack NodeJS SDK

Run the given command to install the BrowserStack NodeJS SDK in your project

Copy icon Copy

Initialize your project for Load Testing

Run the given command from the root directory of your test project to generate the browserstack-load.yml file which contains the configuration required to define and run your load test:

Copy icon Copy

Configure your Load Test

Open the generated browserstack-load.yml file and update it with the relevant test details. Here’s a sample configuration:

Specify the tests

  • The tests block defines the combination of test types you want to run as part of a hybrid load test. Specify Playwright as the testType for one sub-block and k6 for another.
  • For the Playwright sub-block,
    • browserLoadPercent - Specify the percentage of total virtual users to be allocated for Playwright tests.
    • language - Set this to nodejs.
    • files - Define the key files needed to install dependencies and identify which tests to execute.
      • Under dependencies, include the path to files required for environment setup. For Node.js projects, this is typically package.json.
      • Under testConfigs, provide the path to your playwright.config.js.
  • For the k6 sub-block,
    • apiLoadPercent - Specify the percentage of total virtual users to be allocated for k6 tests.
    • testScripts - Set the path to the .js file.

Headless mode

  • You can configure your Playwright load tests to run in either headless or headful mode using the headless capability.
  • Headless mode (default): The browser runs without a visible UI, which is faster and consumes fewer resources. Most CI/CD and automated load tests use headless mode.
  • Headful mode: The browser UI remains visible during test execution.
  • If not specified, tests will run in headless mode by default.

Set reporting structure

Use projectName to group related tests under the same project on the dashboard. Use testName to group multiple runs of the same test.
Both projectName and testName must remain consistent across different runs of the same test.
You can use the following characters in projectName and testName:

  • Letters (A–Z, a–z)
  • Digits (0–9)
  • Periods (.), colons (:), hyphens (-), square brackets ([]), forward slashes (/), at signs (@), ampersands (&), single quotes ('), and underscores (_)
    All other characters are ignored.

You can configure the following load parameters to customize your load test:

browserstack-load.yml
Copy icon Copy

Run the Load Test

Run the given command to start your test:

Copy icon Copy

Check out the FAQs section to get answers to commonly asked questions.

View test results

Once the test starts running, you’ll get a link to the test report.

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

  • ON THIS PAGE

    Is this page helping you?

    Yes
    No

    We're sorry to hear that. Please share your feedback so we can do better

    Contact our Support team for immediate help while we work on improving our docs.

    We're continuously improving our docs. We'd love to know what you liked





    Thank you for your valuable feedback!

    Talk to an Expert
    Download Copy Check Circle