mirror of
https://github.com/appium/appium.git
synced 2026-10-26 02:29:38 +08:00
Kazuaki Matsuo
3ec8e5675f
* fix wrong coordinate for android and ios * separate fixScaleTemplateImage * add fixScaleTemplateImage as a settings * take care of both landscape and portrate * rename to fixTemplateImageScale * rename ratio to scale * does not scale if the arg is non number * rename preference name, default value * remove comment outted lines * add null filter as safer way
88 lines
3.3 KiB
JavaScript
88 lines
3.3 KiB
JavaScript
import _ from 'lodash';
|
||
import log from './logger';
|
||
import { DEFAULT_MATCH_THRESHOLD } from './commands/images';
|
||
import { IMAGE_EL_TAP_STRATEGY_W3C } from './image-element';
|
||
|
||
const GLOBAL_DEFAULT_SETTINGS = {
|
||
// value between 0 and 1 representing match strength, below which an image
|
||
// element will not be found
|
||
imageMatchThreshold: DEFAULT_MATCH_THRESHOLD,
|
||
|
||
// if the image returned by getScreenshot differs in size or aspect ratio
|
||
// from the screen, attempt to fix it automatically
|
||
fixImageFindScreenshotDims: true,
|
||
|
||
// whether Appium should ensure that an image template sent in during image
|
||
// element find should have its size adjusted so the match algorithm will not
|
||
// complain
|
||
fixImageTemplateSize: false,
|
||
|
||
// whether Appium should ensure that an image template sent in during image
|
||
// element find should have its scale adjusted to display size so the match
|
||
// algorithm will not complain.
|
||
// e.g. iOS has `width=375, height=667` window rect, but its screenshot is
|
||
// `width=750 × height=1334` pixels. This setting help to adjust the scale
|
||
// if a user use `width=750 × height=1334` pixels's base template image.
|
||
fixImageTemplateScale: false,
|
||
|
||
// whether Appium should re-check that an image element can be matched
|
||
// against the current screenshot before clicking it
|
||
checkForImageElementStaleness: true,
|
||
|
||
// whether before clicking on an image element Appium should re-determine the
|
||
// position of the element on screen
|
||
autoUpdateImageElementPosition: false,
|
||
|
||
// which method to use for tapping by coordinate for image elements. the
|
||
// options are 'w3c' or 'mjsonwp'
|
||
imageElementTapStrategy: IMAGE_EL_TAP_STRATEGY_W3C,
|
||
};
|
||
|
||
// declare settings that are really handled only by basedriver, so downstream
|
||
// drivers can choose to ignore them for their own settings validation, etc...
|
||
const BASEDRIVER_HANDLED_SETTINGS = [
|
||
'imageMatchThreshold',
|
||
'fixImageFindScreenshotDims',
|
||
'fixImageTemplateSize',
|
||
'checkForImageElementStaleness',
|
||
'autoUpdateImageElementPosition',
|
||
'imageElementTapStrategy',
|
||
];
|
||
|
||
class DeviceSettings {
|
||
|
||
constructor (defaultSettings = {}, onSettingsUpdate = null) {
|
||
this._settings = Object.assign({}, GLOBAL_DEFAULT_SETTINGS, defaultSettings);
|
||
this.onSettingsUpdate = onSettingsUpdate;
|
||
}
|
||
|
||
// calls updateSettings from implementing driver every time a setting is changed.
|
||
async update (newSettings) {
|
||
if (!_.isObject(newSettings)) {
|
||
throw new Error('Settings update should be called with valid JSON');
|
||
}
|
||
for (let prop of _.keys(newSettings)) {
|
||
if (_.isUndefined(this._settings[prop])) {
|
||
log.warn(`Didn't know about setting '${prop}'. Are you sure you ` +
|
||
`spelled it correctly? Proceeding anyway. Valid settings: ${_.keys(this._settings)}`);
|
||
}
|
||
if (this._settings[prop] !== newSettings[prop]) {
|
||
// update setting only when there is updateSettings defined.
|
||
if (this.onSettingsUpdate) {
|
||
await this.onSettingsUpdate(prop, newSettings[prop], this._settings[prop]);
|
||
this._settings[prop] = newSettings[prop];
|
||
} else {
|
||
log.errorAndThrow('Unable to update settings; onSettingsUpdate method not found');
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
getSettings () {
|
||
return this._settings;
|
||
}
|
||
}
|
||
|
||
export default DeviceSettings;
|
||
export { DeviceSettings, BASEDRIVER_HANDLED_SETTINGS };
|