https://github.com/rstudio/shinytest

Automated testing for shiny apps
https://github.com/rstudio/shinytest

Last synced: 6 days ago
JSON representation

Automated testing for shiny apps

• Host: GitHub
• URL: https://github.com/rstudio/shinytest
• Owner: rstudio
• License: other
• Created: 2016-08-24T12:19:09.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2024-05-28T17:42:51.000Z (8 months ago)
• Last Synced: 2025-01-13T06:01:59.036Z (13 days ago)
• Language: JavaScript
• Homepage: https://rstudio.github.io/shinytest/
• Size: 5.09 MB
• Stars: 225
• Watchers: 19
• Forks: 55
• Open Issues: 55
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-shiny-extensions - shinytest - Automated testing for Shiny apps. (Developer Tools / Testing)
• jimsghstars - rstudio/shinytest - Automated testing for shiny apps (JavaScript)

README

        
# shinytest

[![CRAN RStudio mirror downloads](http://cranlogs.r-pkg.org/badges/shinytest)](https://www.r-pkg.org/pkg/shinytest)

[![R build status](https://github.com/rstudio/shinytest/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/rstudio/shinytest/actions)

NOTE: **shinytest is deprecated** and may not work with Shiny after version 1.8.1, which was released on 2024-04-02. This is because it is based on a headless browser, PhantomJS, which was last released on 2016-01-24 and is no longer being developed. Going forward, please use [shinytest2](https://github.com/rstudio/shinytest2), which makes use of headless Chromium-based browsers. See the [shinytest to shinytest2 Migration Guide](https://rstudio.github.io/shinytest2/articles/z-migration.html) for more information.

shinytest provides a simulation of a Shiny app that you can control in order to automate testing. shinytest uses a snapshot-based testing strategy: the first time it runs a set of tests for an application, it performs some scripted interactions with the app and takes one or more snapshots of the application’s state. Subsequent runs perform the same scripted interactions then compare the results; you'll get an error if they're different.

## Installation

To install the current release version:

```r

install.packages("shinytest")

```

## Usage

See the [getting started guide](https://rstudio.github.io/shinytest/articles/shinytest.html) to learn how to use shinytest.