Actions script sur smartphone

Les actions script smartphone (application Android, application iOS et web mobile) étendent WebdriverIO avec des helpers pour les fonctionnalités propres à un vrai téléphone : basculer le mode avion, réagir aux événements d'appareil comme un SMS ou un appel entrant, passer et recevoir des appels, et lire ou enregistrer de l'audio. browser et driver sont des alias ; les deux fonctionnent avec chaque helper.

Pour la structure du script, les paramètres et les helpers partagés, commencez par Actions script.

Mode avion (Android)

browser.enableAirplaneMode();
browser.disableAirplaneMode();

isAirplaneModeEnabled() retourne l'état actuel. enableAirplaneMode, disableAirplaneMode et toggleAirplaneMode ne font rien si le téléphone est déjà dans l'état demandé, et retournent une erreur Not implemented sur iOS. Tous acceptent des paramètres optionnels :

Événements d'appareil

Deux helpers fonctionnent ensemble : addEventListener réagit aux événements au fur et à mesure, et waitForEvent bloque jusqu'à ce qu'un événement se produise. Pour capturer des événements avec un listener, l'étape doit aussi en attendre un.

driver.addEventListener((event) => { console.log("Received", event) }, new CellularEvent());
driver.waitForEvent(new ActiveCallEvent(), {
  timeout: 45000,
  timeoutMsg: "call never became active"
});

waitForEvent(expectedEvent, options) fait échouer l'étape si l'événement ne se produit pas dans le timeout (par défaut 5000 ms). Options : timeout, timeoutMsg, interval (par défaut 500 ms), requestTimeout (par défaut 2000 ms). Passer une classe d'événement parente correspond à tous ses enfants ; ne rien passer à addEventListener écoute tout.

Chaque événement contient kind, name et time.

Recevoir un OTP par SMS

Le schéma standard sur Android : commencez à attendre le SMS dans l'étape qui le déclenche, puis lisez-le dans l'étape suivante.

let promise;

it('Click on "VALIDATE"', function () {
  $('//*[contains(@text,"VALIDATE")]').click();
  promise = driver.waitForEvent(new ReceivedSMSEvent(), {
    timeout: 45000,
    timeoutMsg: "sms not received",
  });
});

it('Get OTP sms', async function () {
  const { event } = await promise;
  const regex = /This is your OTP code: (\d{4})/gm;
  const m = regex.exec(_.get(event, 'payload.body', ''));
  test.variables.set("OTP", m[1]);
});

Sur iOS il n'y a pas d'événement SMS : lisez la bannière de notification à la place, avec un délai généreux.

it('Wait for OTP sms', function () {
  const elem = $('//*[contains(@name,"NotificationShortLookView")]');
  elem.waitForExist({ timeout: 35000, interval: 50 });
  const m = /(\d{4})/gm.exec(elem.getText());
  if (m != null) { sms_code = m[0]; }
});

Adaptez la regex au message que vous attendez dans les deux cas.

Appels

const report = driver.placeCall("0123456789", {
  timeout_wait_compose: 30,
  timeout_ring_call: 30,
  sound_filename: "file-0m30s",
});
// report: { dial_time: 1.454, ring_time: 0.454, call_time: 43.532 }

placeCall(number, options) compose et retourne des métriques de temps. Options : timeout_wait_compose et timeout_ring_call (secondes ; dépasser l'un ou l'autre lève une exception), sound_filename (audio joué à l'autre côté : file-0m30s à file-3m), debug.

const report = driver.waitCall({
  timeout_incoming_call: 90,
  timeout_pickup_call: 20,
  timeout_end_call: 300,
  mos_activate: true,
  mos_listening_condition: "NB",
  mos_ref_file: "voice-30s",
  mos_algo: "polqa",
});
// report: { incoming_time: 1.454, pickup_time: 4.39, call_time: 43.532 }

waitCall(options) répond à un appel entrant et retourne des métriques de temps, avec évaluation optionnelle de l'audio : mos_listening_condition est NB (voix 2G/3G) ou SWB (VoLTE), mos_algo est polqa (licence requise), visqol ou aqua, et mos_ref_file l'audio de référence.

Audio

driver.playSound({ sound_filename: "file-0m30s" });   // blocks during playback

driver.startRecordSound({ mos_activate: true, mos_listening_condition: "NB", mos_ref_file: "file-0m30s", mos_algo: "polqa" });
// ... the audio you want to capture ...
driver.stopRecordSound();   // waits for the recording to finish

startRecordSound est asynchrone ; stopRecordSound l'arrête et déclenche le calcul du MOS quand il est activé.

Et ensuite ?