Automation selectors for Web and Mobile Apps

A mini-package for iOS (testID), Android (accessibilityLabel) and web (data-test) property assignment based on environment & Platform.

Installation

Install automation-selectors with NPM or yarn

1. Add automation-selectors as a devDependency:

   npm install --save-dev automation-selectors

   yarn add -D automation-selectors

2. In your project create a module and pass in all the necessary props.

   RN Example:

   import { Platform } from "react-native";
   import { qaID } from "automation-selectors";
   
   export const selector = (selectorValue?: string) => {
     if (process.env.NODE_ENV !== "production") {
       return qaID(selectorValue || "", Platform.OS);
     }
   };

   Web Example:

   import { qaID } from "automation-selectors";
   
   export const selector = (selectorValue?: string) => {
     if (process.env.NODE_ENV !== "production") {
       return qaID(selectorValue || "", 'web');
     }
   };

3. Invoke selectors in components:

   import { selector } from 'path/to/module';
   ...
   <View
       {...selector('VIEW_HOMEPAGE')}
   />
   ...
   };

4. At this point your selector becomes a testID, accessibilityLabel or data-test based on OS.