Clear app data - operation

  • Android
  • Browsers
  • HbbTV / Freeview Play
  • LG webOS / Netcast
  • NextGen TV / ATSC 3.0
  • PlayStation 4/5
  • Samsung Tizen / Orsay
  • Sky
  • VIDAA
  • Vizio SmartCast
  • Xbox (One, Series X/S)
  • Xfinity / Xumo TV / XClass TV
  • Xumo (Entertainment OS)
  • Other Smart TVs and STBs - HTML apps

This operation attempts to delete local data of the app during the test run so that application is reset to its initial state before the next test step executes.


To perform this operation in the Suitest Test editor use the Clear app data line:

Clear app data

To perform this operation in the Suitest JavaScript API use the clearAppData command:

await suitest.clearAppData();

Use cases

The application may store some data locally to remember a particular user preference or setting. Sometimes it is practical to empty the stores in order to test a particular piece of functionality.

For example if a user checks "Don't show this dialog again" on a certain popup the application may choose to store users choice in a local data store. Resetting the store will cause the popup to appear again.

What data is deleted

Platform Data deleted
Android Local storage
HbbTV / Freeview Play Cookies and local storage
HTML-based Cookies and local storage
Xbox (One, Series X/S) Native Application data (local, roaming and temporary data stores)
Xbox (One, Series X/S) HTML Application data (local, roaming and temporary data stores), cookies and local storage

Automatic local data clearing

Application's local data can be cleared in several cases:

  1. For packaged applications, local data is cleared every time the application is re-installed on the device.
  2. For hosted HTML-based (i.e. URL-based) application that use Suitestify, local data is updated whenever Suitestify session is started. In automated mode this means on the start of every test. In interactive mode this means every time you connect to a device. Whenever Suitestify session is started, a new domain is generated for the application, thus all domain-dependent data (cookies, local storage etc.) would be cleared.