runTests: Runs the tests associated with this Shiny app

View source: R/test.R

runTestsR Documentation

Runs the tests associated with this Shiny app


Sources the .R files in the top-level of ⁠tests/⁠ much like ⁠R CMD check⁠. These files are typically simple runners for tests nested in other directories under ⁠tests/⁠.


runTests(appDir = ".", filter = NULL, assert = TRUE, envir = globalenv())



The base directory for the application.


If not NULL, only tests with file names matching this regular expression will be executed. Matching is performed on the file name including the extension.


Logical value which determines if an error should be thrown if any error is captured.


Parent testing environment in which to base the individual testing environments.


Historically, shinytest recommended placing tests at the top-level of the ⁠tests/⁠ directory. This older folder structure is not supported by runTests. Please see shinyAppTemplate() for more details.


A data frame classed with the supplemental class "shiny_runtests". The data frame has the following columns:

Name Type Meaning
file character(1) File name of the runner script in ⁠tests/⁠ that was sourced.
pass logical(1) Whether or not the runner script signaled an error when sourced.
result any or NA The return value of the runner

shiny documentation built on May 29, 2024, 8:47 a.m.