djoksimo/coverage-360

Scena 360's e2e testing setup using Jest, Puppeteer, and Github Actions

coverage-360

Scena 360's end-to-end testing setup.

---

Join the Scena 360 Community!

Features

• Works with A-frame VR entities (in 'headful' mode)
• Uses jest-puppeteer:
  • Jest
  • Puppeteer
• Run tests in Github Actions using the Headful Puppeteer action

Use cases

• Learn how to write tests that modify entities programmatically and visually inspect them
• Test VR interactions when you don't have a headset
• Set up e2e tests and a CI pipeline for your A-frame projects
• Use this repository for inspiration and make your A-frame projects more reliable!
• Automate and run e2e tests in the cloud using Github Actions

Running the Example

1. Make sure that you have the latest stable version of Yarn and Node.JS installed

2. Run yarn intsall

3. Run yarn test:e2e to run the example e2e test suite (e2e/example.test.js)

File Structure

|_ .github
  |_ workflows/ # the Github Action configuration
|_ e2e
  |_ helpers # helpers/utilties for testing, querying/manipulating entities elements, etc.
  |_ example.test.js # example test suite
  |_ jest.config.js # Jest configuration
|_ .babelrc # Babel configuration so that imports/exports work
|_ index.html # sample Aframe application from aframe.io
|_ jest-puppeteer.config.js # https://github.com/smooth-code/jest-puppeteer/#configure-puppeteer

---

• Contributions and forks are welcome!
• Questions, suggestions, etc. can be posted in the issues tab or in the Scena 360 Community
• More examples and resources coming soon!