browsertrix/frontend/tests/README.md
Emma Segal-Grossman b5fe5551c5
Ensure linting & formatting runs in CI (#1512)
Makes sure code quality stays high by checking that code is linted &
formatted in CI.

### Reason

Frustration — so that [things like
this](https://github.com/webrecorder/browsertrix-cloud/pull/1500#issuecomment-1920087667)
don't happen in the future. I tried to merge `main` into a branch to get
it up to date with main, and main isn't totally formatted or linted
properly, and then formatting the codebase introduced a whole bunch of
unrelated changes. Running a formatter or linter shouldn't cause
unrelated code changes, and `main` should always be in a correct state
in terms of linting and formatting.

### Testing

- [x] Test run with failing lint checks errors:
https://github.com/webrecorder/browsertrix-cloud/actions/runs/7733354321/job/21085236200
- [x] Test run with failing formatting check errors:
https://github.com/webrecorder/browsertrix-cloud/actions/runs/7733501666/job/21085717519
- [x] Test run with both passing lint & formatting checks passes:
https://github.com/webrecorder/browsertrix-cloud/actions/runs/7733529142/job/21085796727
2024-01-31 18:25:44 -05:00

53 lines
1.1 KiB
Markdown

# Running Tests Locally
This guide will show you how to run tests locally for a frontend application using `yarn start` and `npx playwright test`.
## Prerequisites
Before getting started, you should have the following installed on your computer:
- Node.js
- Yarn
## Step 1: Clone the repository
Begin by cloning the repository to your local machine.
`git clone git@github.com:webrecorder/browsertrix-cloud.git`
## Step 2: Change directory to frontend
Navigate to the frontend directory:
`cd frontend`
## Step 3: Install dependencies
Install the project's dependencies:
`yarn install`
## Step 4: Add `.env`
Add a `.env` file by copying the sample:
`cp sample.env.local .env`
## Step 5: Start the application
Start the application:
`yarn start`
This will open the application in your browser at `http://localhost:5173`.
## Step 5: Open a new terminal tab
Open a new terminal tab so that the first one continues to run the application.
## Step 6: Run tests
Run the tests in the new terminal tab using `npx playwright test`.
This will run the tests and output the results in the terminal.