Test Observability on Playwright Node.js
Quick start guide to integrate BrowserStack Test Observability with Playwright Node.js
Pre-requisites
- You have an account with BrowserStack (even a free trial works) and can get your Username and Access Key from Settings.
- You have a Playwright v1.31 or higher test suite, (it is okay even if you do not run your tests on BrowserStack infrastructure).
- You use the Playwright test runner in your tests. The
testvariable used in writing the tests should be imported from@playwright/test. - Note: Test Observability does not support Node versions
12.22.12,20.0.0,20.1.0and20.2.0currrently.
Integrate with Test Observability
BrowserStack Test Observability can be used regardless of where your tests run - whether on BrowserStack’s devices and browsers, locally on your laptop, CI machines, or using another cloud provider.
Install or update to the latest version of BrowserStack Node SDK
Go to your Playwright project’s root directory and run the following commands to update or install the BrowserStack Node SDK and later check the installed version as shown below:
npm i -D browserstack-node-sdk
npm list browserstack-node-sdk
Please ensure that you now have at least browserstack-node-sdk v1.21.1 before proceeding.
Create the browserstack.yml file
If you don’t already have a browserstack.yml file, run the following command to create one:
npx setup --username 'YOUR_USERNAME' --key 'YOUR_ACCESS_KEY'
Set up the browserstack.yml file
Set up the browserstack.yml file as follows:
userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY
buildName: "Your static build/job name goes here"
projectName: "Your static project name goes here"
...
The projectName and buildName config must be static and not change across different runs of the same build.
Please note that if you are running tests on BrowserStack Automate already, this SDK is only for Test Observability and will not override the capabilities you have configured in browserstack.config.js. This means if you want to have the same build & project names across Test Observability & BrowserStack Automate, you need to maintain the same values across both browserstack.config.js and browserstack.yml.
Run your suite with BrowserStack Test Observability
Prepend browserstack-node-sdk to the existing command that you use to trigger a run as shown below and data will automatically start getting sent to BrowserStack Test Observability.
npx browserstack-node-sdk "Your existing command for running your test suite. E.g. <playwright test sample --project=chromium>"
Post build run completion, you will see the build URL of Test Observability. Alternatively, you can also navigate to your build run using Build Runs.
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
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!
