test: set up included-non-root example screenshot

[MikeMcC399]

Issue

examples/included-as-non-root cannot capture screenshots when running with a non-root user in GitHub Actions.

In actions/workflows/example-tests.yml running the job example (included-as-non-root) in GitHub Actions, Cypress outputs the warning:

This folder is not writable: /test

Writing to this directory is required by Cypress in order to store screenshots and videos.

Enable write permissions to this directory to ensure screenshots and videos are stored.

If you don't require screenshots or videos to be stored you can safely ignore this warning.

See logs in https://github.com/cypress-io/cypress-docker-images/actions/runs/12585519287/job/35077469532

The workflow effectively runs the following:

cypress-docker-images/examples/included-as-non-root/scripts/test.sh

Lines 1 to 7 in 31d5a60

	#!/bin/bash
	set -e # fail on error
	#
	# Run in examples/included-as-non-root directory
	#
	echo Test cypress/included running under node \(non-root\) user
	docker run --rm -v .:/test -w /test -u node cypress/included

GitHub Runners under ubuntu-24.04 run commands with the Linux user:

uid=1001(runner) gid=118(docker) groups=118(docker),4(adm),100(users),999(systemd-journal)

The volume mount -v .:/test source is owned by the runner user and the Cypress node user has only r-x access, not write access to the directory /test.

Note that this is different from running Docker images as an explicit container in GitHub Actions (see Running jobs in a container where the Docker (default) user is root unless replaced through jobs.<job_id>.container.options).

Change

1. In the Cypress configuration examples/included-as-non-root/cypress.config.js configure the volatile folders outside the Cypress project in the /tmp directory which is writable by all users.

   Folder	Default Location	New Location
   downloadsFolder	cypress/downloads	/tmp/cypress/downloads
   screenshotsFolder	cypress/screenshots	/tmp/cypress/screenshots
   videosFolder	cypress/videos	/tmp/cypress/videos

2. Add cy.screenshot() to examples/included-as-non-root/cypress/e2e/spec.cy.js to test that a screenshot can be captured.

Verification

Local test Ubuntu

Ubuntu 24.04.1 LTS, Node.js 22.12.0 LTS, Docker Desktop 4.37.1

git clone https://github.com/cypress-io/cypress-docker-images
cd cypress-docker-images
cd examples/included-as-non-root
docker run --rm -v .:/test:ro -w /test -u node cypress/included

• Ignore the warning "This folder is not writable: /test" (see issue Read-only warning given even when screenshots and videos folders writable cypress#30810)
• Confirm that screenshot /tmp/cypress/screenshots/spec.cy.js/test local demo page -- heading.png is logged as being written.

Local test Windows 11

Windows 11 24H2, Node.js 22.12.0 LTS, Docker Desktop 4.37.1 in a cmd terminal window

Commands and test as above for Ubuntu.

[cypress-app-bot]

• Create a Draft Pull Request if your PR is not ready for review. Mark the PR as Ready for Review when you're ready for a Cypress team member to review the PR.