/*jshint node: true, jasmine: true */ /* * * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. * */ // these tests are meant to be executed by Cordova Paramedic test runner // you can find it here: https://github.com/apache/cordova-paramedic/ // it is not necessary to do a full CI setup to run these tests // just run "node cordova-paramedic/main.js --platform ios --plugin cordova-plugin-camera" 'use strict'; var wdHelper = global.WD_HELPER; var screenshotHelper = global.SCREENSHOT_HELPER; var isDevice = global.DEVICE; var cameraConstants = require('../../www/CameraConstants'); var cameraHelper = require('../helpers/cameraHelper'); var MINUTE = 60 * 1000; var DEFAULT_WEBVIEW_CONTEXT = 'WEBVIEW_1'; var PROMISE_PREFIX = 'appium_camera_promise_'; var CONTEXT_NATIVE_APP = 'NATIVE_APP'; describe('Camera tests iOS.', function () { var driver; var webviewContext = DEFAULT_WEBVIEW_CONTEXT; // promise count to use in promise ID var promiseCount = 0; // going to set this to false if session is created successfully var failedToStart = true; // points out which UI automation to use var isXCUI = false; // spec counter to restart the session var specsRun = 0; function getNextPromiseId() { promiseCount += 1; return getCurrentPromiseId(); } function getCurrentPromiseId() { return PROMISE_PREFIX + promiseCount; } function gracefullyFail(error) { fail(error); return driver .quit() .then(function () { return getDriver(); }); } // generates test specs by combining all the specified options // you can add more options to test more scenarios function generateOptions() { var sourceTypes = cameraConstants.PictureSourceType; var destinationTypes = cameraConstants.DestinationType; var encodingTypes = cameraConstants.EncodingType; var allowEditOptions = [ true, false ]; var correctOrientationOptions = [ true, false ]; return cameraHelper.generateSpecs(sourceTypes, destinationTypes, encodingTypes, allowEditOptions, correctOrientationOptions); } function usePicture() { return driver .elementByXPath('//*[@label="Use"]') .click() .fail(function () { if (isXCUI) { return driver .waitForElementByAccessibilityId('Choose', MINUTE / 3) .click(); } // For some reason "Choose" element is not clickable by standard Appium methods on iOS <= 9 return wdHelper.tapElementByXPath('//UIAButton[@label="Choose"]', driver); }); } function clickPhoto() { if (isXCUI) { // iOS >=10 return driver .context(CONTEXT_NATIVE_APP) .elementsByXPath('//XCUIElementTypeCell') .then(function(photos) { if (photos.length == 0) { return driver .sleep(0) // driver.source is not a function o.O .source() .then(function (src) { console.log(src); gracefullyFail('Couldn\'t find an image to click'); }); } // intentionally clicking the second photo here // the first one is not clickable for some reason return photos[1].click(); }); } // iOS <10 return driver .elementByXPath('//UIACollectionCell') .click(); } function getPicture(options, cancelCamera, skipUiInteractions) { var promiseId = getNextPromiseId(); if (!options) { options = {}; } return driver .context(webviewContext) .execute(cameraHelper.getPicture, [options, promiseId]) .context(CONTEXT_NATIVE_APP) .then(function () { if (skipUiInteractions) { return; } if (options.hasOwnProperty('sourceType') && options.sourceType === cameraConstants.PictureSourceType.PHOTOLIBRARY) { return driver .waitForElementByAccessibilityId('Camera Roll', MINUTE / 2) .click() .then(function () { return clickPhoto(); }) .then(function () { if (!options.allowEdit) { return driver; } return usePicture(); }); } if (options.hasOwnProperty('sourceType') && options.sourceType === cameraConstants.PictureSourceType.SAVEDPHOTOALBUM) { return clickPhoto() .then(function () { if (!options.allowEdit) { return driver; } return usePicture(); }); } if (cancelCamera) { return driver .waitForElementByAccessibilityId('Cancel', MINUTE / 2) .click(); } return driver .waitForElementByAccessibilityId('Take Picture', MINUTE / 2) .click() .waitForElementByAccessibilityId('Use Photo', MINUTE / 2) .click(); }) .fail(fail); } // checks if the picture was successfully taken // if shouldLoad is falsy, ensures that the error callback was called function checkPicture(shouldLoad, options) { if (!options) { options = {}; } return driver .context(webviewContext) .setAsyncScriptTimeout(MINUTE / 2) .executeAsync(cameraHelper.checkPicture, [getCurrentPromiseId(), options]) .then(function (result) { if (shouldLoad) { if (result !== 'OK') { fail(result); } } else if (result.indexOf('ERROR') === -1) { throw 'Unexpected success callback with result: ' + result; } }); } // takes a picture with the specified options // and then verifies it function runSpec(options, done, pending) { if (options.sourceType === cameraConstants.PictureSourceType.CAMERA && !isDevice) { pending('Camera is not available on iOS simulator'); } checkSession(done); specsRun += 1; return driver .then(function () { return getPicture(options); }) .then(function () { return checkPicture(true, options); }) .fail(gracefullyFail); } function getDriver() { failedToStart = true; driver = wdHelper.getDriver('iOS'); return wdHelper.getWebviewContext(driver) .then(function(context) { webviewContext = context; return driver.context(webviewContext); }) .then(function () { return wdHelper.waitForDeviceReady(driver); }) .then(function () { return wdHelper.injectLibraries(driver); }) .sessionCapabilities() .then(function (caps) { var platformVersion = parseFloat(caps.platformVersion); isXCUI = platformVersion >= 10.0; }) .then(function () { var options = { quality: 50, allowEdit: false, sourceType: cameraConstants.PictureSourceType.SAVEDPHOTOALBUM, saveToPhotoAlbum: false, targetWidth: 210, targetHeight: 210 }; return driver .then(function () { return getPicture(options, false, true); }) .context(CONTEXT_NATIVE_APP) .acceptAlert() .then(function alertDismissed() { // TODO: once we move to only XCUITest-based (which is force on you in either iOS 10+ or Xcode 8+) // UI tests, we will have to: // a) remove use of autoAcceptAlerts appium capability since it no longer functions in XCUITest // b) can remove this entire then() clause, as we do not need to explicitly handle the acceptAlert // failure callback, since we will be guaranteed to hit the permission dialog on startup. }, function noAlert() { // in case the contacts permission alert never showed up: no problem, don't freak out. // This can happen if: // a) The application-under-test already had photos permissions granted to it // b) Appium's autoAcceptAlerts capability is provided (and functioning) }) .elementByAccessibilityId('Cancel', 10000) .click(); }) .then(function () { failedToStart = false; }); } function checkSession(done) { if (failedToStart) { fail('Failed to start a session'); done(); } } it('camera.ui.util configure driver and start a session', function (done) { getDriver() .fail(fail) .done(done); }, 15 * MINUTE); describe('Specs.', function () { afterEach(function (done) { if (specsRun >= 15) { specsRun = 0; // we need to restart the session regularly because for some reason // when running against iOS 10 simulator on SauceLabs, // Appium cannot handle more than ~20 specs at one session // the error would be as follows: // "Could not proxy command to remote server. Original error: Error: connect ECONNREFUSED 127.0.0.1:8100" checkSession(done); return driver .quit() .then(function () { return getDriver(); }) .done(done); } else { done(); } }, 15 * MINUTE); // getPicture() with mediaType: VIDEO, sourceType: PHOTOLIBRARY it('camera.ui.spec.1 Selecting only videos', function (done) { checkSession(done); specsRun += 1; var options = { sourceType: cameraConstants.PictureSourceType.PHOTOLIBRARY, mediaType: cameraConstants.MediaType.VIDEO }; driver // skip ui unteractions .then(function () { return getPicture(options, false, true); }) .waitForElementByXPath('//*[contains(@label,"Videos")]', MINUTE / 2) .elementByAccessibilityId('Cancel') .click() .fail(gracefullyFail) .done(done); }, 7 * MINUTE); // getPicture(), then dismiss // wait for the error callback to be called it('camera.ui.spec.2 Dismissing the camera', function (done) { checkSession(done); if (!isDevice) { pending('Camera is not available on iOS simulator'); } specsRun += 1; var options = { sourceType: cameraConstants.PictureSourceType.CAMERA, saveToPhotoAlbum: false }; driver .then(function () { return getPicture(options, true); }) .then(function () { return checkPicture(false); }) .fail(gracefullyFail) .done(done); }, 7 * MINUTE); it('camera.ui.spec.3 Verifying target image size, sourceType=CAMERA', function (done) { var options = { quality: 50, allowEdit: false, sourceType: cameraConstants.PictureSourceType.CAMERA, saveToPhotoAlbum: false, targetWidth: 210, targetHeight: 210 }; runSpec(options, done, pending).done(done); }, 7 * MINUTE); it('camera.ui.spec.4 Verifying target image size, sourceType=SAVEDPHOTOALBUM', function (done) { var options = { quality: 50, allowEdit: false, sourceType: cameraConstants.PictureSourceType.SAVEDPHOTOALBUM, saveToPhotoAlbum: false, targetWidth: 210, targetHeight: 210 }; runSpec(options, done, pending).done(done); }, 7 * MINUTE); it('camera.ui.spec.5 Verifying target image size, sourceType=PHOTOLIBRARY', function (done) { var options = { quality: 50, allowEdit: false, sourceType: cameraConstants.PictureSourceType.PHOTOLIBRARY, saveToPhotoAlbum: false, targetWidth: 210, targetHeight: 210 }; runSpec(options, done, pending).done(done); }, 7 * MINUTE); it('camera.ui.spec.6 Verifying target image size, sourceType=CAMERA, destinationType=FILE_URL', function (done) { // remove this line if you don't mind the tests leaving a photo saved on device pending('Cannot prevent iOS from saving the picture to photo library'); var options = { quality: 50, allowEdit: false, sourceType: cameraConstants.PictureSourceType.CAMERA, destinationType: cameraConstants.DestinationType.FILE_URL, saveToPhotoAlbum: false, targetWidth: 210, targetHeight: 210 }; runSpec(options, done, pending).done(done); }, 7 * MINUTE); it('camera.ui.spec.7 Verifying target image size, sourceType=SAVEDPHOTOALBUM, destinationType=FILE_URL', function (done) { var options = { quality: 50, allowEdit: false, sourceType: cameraConstants.PictureSourceType.SAVEDPHOTOALBUM, destinationType: cameraConstants.DestinationType.FILE_URL, saveToPhotoAlbum: false, targetWidth: 210, targetHeight: 210 }; runSpec(options, done, pending).done(done); }, 7 * MINUTE); it('camera.ui.spec.8 Verifying target image size, sourceType=PHOTOLIBRARY, destinationType=FILE_URL', function (done) { var options = { quality: 50, allowEdit: false, sourceType: cameraConstants.PictureSourceType.PHOTOLIBRARY, destinationType: cameraConstants.DestinationType.FILE_URL, saveToPhotoAlbum: false, targetWidth: 210, targetHeight: 210 }; runSpec(options, done, pending).done(done); }, 7 * MINUTE); it('camera.ui.spec.9 Verifying target image size, sourceType=CAMERA, destinationType=FILE_URL, quality=100', function (done) { // remove this line if you don't mind the tests leaving a photo saved on device pending('Cannot prevent iOS from saving the picture to photo library'); var options = { quality: 100, allowEdit: false, sourceType: cameraConstants.PictureSourceType.CAMERA, destinationType: cameraConstants.DestinationType.FILE_URL, saveToPhotoAlbum: false, targetWidth: 305, targetHeight: 305 }; runSpec(options, done, pending).done(done); }, 7 * MINUTE); it('camera.ui.spec.10 Verifying target image size, sourceType=SAVEDPHOTOALBUM, destinationType=FILE_URL, quality=100', function (done) { var options = { quality: 100, allowEdit: false, sourceType: cameraConstants.PictureSourceType.SAVEDPHOTOALBUM, destinationType: cameraConstants.DestinationType.FILE_URL, saveToPhotoAlbum: false, targetWidth: 305, targetHeight: 305 }; runSpec(options, done, pending).done(done); }, 7 * MINUTE); it('camera.ui.spec.11 Verifying target image size, sourceType=PHOTOLIBRARY, destinationType=FILE_URL, quality=100', function (done) { var options = { quality: 100, allowEdit: false, sourceType: cameraConstants.PictureSourceType.PHOTOLIBRARY, destinationType: cameraConstants.DestinationType.FILE_URL, saveToPhotoAlbum: false, targetWidth: 305, targetHeight: 305 }; runSpec(options, done, pending).done(done); }, 7 * MINUTE); // combine various options for getPicture() generateOptions().forEach(function (spec) { it('camera.ui.spec.12.' + spec.id + ' Combining options. ' + spec.description, function (done) { // remove this check if you don't mind the tests leaving a photo saved on device if (spec.options.sourceType === cameraConstants.PictureSourceType.CAMERA && spec.options.destinationType === cameraConstants.DestinationType.NATIVE_URI) { pending('Skipping: cannot prevent iOS from saving the picture to photo library and cannot delete it. ' + 'For more info, see iOS quirks here: https://github.com/apache/cordova-plugin-camera#ios-quirks-1'); } runSpec(spec.options, done, pending).done(done); }, 7 * MINUTE); }); }); it('camera.ui.util Destroy the session', function (done) { checkSession(done); driver .quit() .done(done); }, 5 * MINUTE); });