Docs for Web on Github Actions

[Fishbowler]

Requested in mobile-dev-inc/Maestro#2352

[Angelk90]

@Fishbowler : I managed to get it working, below the image result, some considerations below the image.

test_script_web.yaml:

url: https://www.maestro.dev
---
- launchApp
- takeScreenshot: MainScreen

Test.yml:

name: Maestro Web Testing

on:
  push:
    branches:
      - main

jobs:
  maestro-web-tests:
    runs-on: macos-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Install Maestro CLI
        run: curl -fsSL "https://get.maestro.mobile.dev" | bash

      - name: Run the test with Maestro on Web
        run: |
          export PATH="$PATH:$HOME/.maestro/bin"
          export MAESTRO_CLI_ANALYSIS_NOTIFICATION_DISABLED=true
          maestro test ./test/test_script_web.yaml

      - name: Upload screenshot as artifact
        uses: actions/upload-artifact@v4
        with:
          name: screenshot-artifact
          path: ./MainScreen.png

Result:

Considerations:

1. Every time you use the maestro command, always put before:
   export PATH="$PATH:$HOME/.maestro/bin", the path between one step and another does not remain updated I do not know why, if they are all in a single step section you can use it only once maybe.

2. I tried to set: export MAESTRO_CLI_ANALYSIS_NOTIFICATION_DISABLED=true in a step before but it does not work, I think the same thing as point 1)

OT:

1. I noticed that the image quality is a bit poor, I wonder if it is because it uses github action or if the takeScreenshot command is just like that.

2. Is there a way to take a screenshot of the entire web page?

[Angelk90]

@Fishbowler : I tried to do some tests, modifying the scripts, when I try to pass a variable to the script test_script_web it doesn't work, it seems that it tries to start a devices emulator, not the browser.

test_script_web.yaml:

url: ${URL}
---
- launchApp
- takeScreenshot: MainScreen

Test.yml:

      - name: Run the test with Maestro on Web
        run: |
          export PATH="$PATH:$HOME/.maestro/bin"
          export MAESTRO_CLI_ANALYSIS_NOTIFICATION_DISABLED=true
          maestro test -e URL=${{ github.event.inputs.url }} ./test/test_script_web.yaml

Error:

Want to use 0 devices, which is not enough to run 1 shards. Missing 1 device(s).
Not enough devices connected (1) to run the requested number of shards (1).

[Fishbowler]

You've stumbled on mobile-dev-inc/Maestro#2383

[Angelk90]

@Fishbowler : This works: #118 (comment)