XCTestAPI文档Word下载.docx
- 文档编号:22163997
- 上传时间:2023-02-02
- 格式:DOCX
- 页数:26
- 大小:35.21KB
XCTestAPI文档Word下载.docx
《XCTestAPI文档Word下载.docx》由会员分享,可在线阅读,更多相关《XCTestAPI文档Word下载.docx(26页珍藏版)》请在冰豆网上搜索。
a"
@"
);
//如果断言没问题,就调用fulfill宣布测试满足
[expfulfill];
}];
//设置延迟多少秒后,如果没有满足测试条件就报错
[selfwaitForExpectationsWithTimeout:
3handler:
^(NSError*_Nullableerror){
if(error){
NSLog(@"
TimeoutError:
%@"
error);
}
-(XCTestExpectation*)expectationForPredicate:
(NSPredicate*)predicateevaluatedWithObject:
(id)objecthandler:
(XCPredicateExpectationHandler)handler;
利用谓词计算,如果限定时间内满足条件则通过测试
-(void)testThatBackgroundImageChanges{
XCTAssertNil([self.buttonbackgroundImageForState:
UIControlStateNormal]);
NSPredicate*predicate=[NSPredicatepredicateWithBlock:
^BOOL(UIButton*_Nonnullbutton,NSDictionary<
NSString*,id>
*_Nullablebindings){
return[buttonbackgroundImageForState:
UIControlStateNormal]!
=nil;
[selfexpectationForPredicate:
predicate
evaluatedWithObject:
self.button
handler:
nil];
20handler:
-(XCTestExpectation*)expectationForNotification:
(NSString*)notificationNameobject:
(id)objectToObservehandler:
(XCNotificationExpectationHandler)handler;
监听一个通知,如果在规定时间内正确收到通知则测试通过。
-(void)testAsynExample1{
[selfexpectationForNotification:
(@"
监听通知的名称xxx"
)object:
nilhandler:
[[NSNotificationCenterdefaultCenter]postNotificationName:
object:
-(XCTestExpectation*)keyValueObservingExpectationForObject:
(id)objectToObservekeyPath:
(NSString*)keyPathexpectedValue:
(id)expectedValue;
创建一个KVO观察模式
(NSString*)keyPathhandler:
(XCKeyValueObservingExpectationHandler)handler;
-(void)waitForExpectationsWithTimeout:
(NSTimeInterval)timeouthandler:
(XCWaitCompletionHandler)handler;
设定等待时间,等待时间内满足所有条件则测试通过,成功或超时都会执行handlerblock(optional)
typedefBOOL(^XCPredicateExpectationHandler)(void);
如果未提供Handle,第一次测试通过即满足条件,如果提供了Handle,它能覆盖原有的行为和条件,那么将重新判定是否满足条件。
typedefBOOL(^XCNotificationExpectationHandler)(NSNotification*notification);
获得符合期望的通知时将被调用,满足条件为Yes
typedefBOOL(^XCKeyValueObservingExpectationHandler)(idobservedObject,NSDictionary*change);
当KVO监视的值反正改变是调用,满足条件为Yes
typedefvoid(^XCWaitCompletionHandler)(NSError*error);
当测试成功或超时时调用,需要指定error类型,否则error=nil;
@propertyBOOLcontinueAfterFailure;
默认为Yes,当case中某条测试语句失败时会继续向下执行,实测只向下执行了一步,待验证。
-(void)measureBlock:
(void(^)(void))block;
测试块中代码的性能。
-(void)measureMetrics:
(NSArray<
NSString*>
*)metricsautomaticallyStartMeasuring:
(BOOL)automaticallyStartMeasuringforBlock:
measureBlock的拓展版,当需要自定义测量的开始点和结束点时,又或者要测量多个指标时调用此方法。
Metrics:
是测量标准数组;
automaticallyStartMeasuring为真时,自动开始测试,为假则需要startMeasuring作为启动点。
注意在一个代码块中开始点和结束点只能各有一个,出现一下情况时测试将会失败:
automaticallyStartMeasuring=YES且代码块中调用了startMeasuring方法;
automaticalltStattMeasuring=NO且代码块中没调用或多次调用了startMeasuring方法;
在代码块中多次调用了stopMeasuring方法。
-(void)startMeasuring;
在measureBlock中调用此方法来标记一个测量起点。
-(void)stopMeasuring;
在measureBlock中调用此方法来标记一个结束点。
+(NSArray<
*)defaultPerformanceMetrics;
这是调用measureBlock时默认使用的测量标准数组。
-(id<
NSObject>
)addUIInterruptionMonitorWithDescription:
(NSString*)handlerDescriptionhandler:
(BOOL(^)(XCUIElement*interruptingElement))handler;
在当前上下文中添加一个Handle
handlerDescription:
用于阐述这个Handle的作用和行为,主要被用来Debug和分析
异步测试
XCTestExpectation
使用以下XCTestCase方法来创建XCTestExpectation实例:
expectationWithDescription:
expectationForPredicate:
evaluatedWithObject:
handler:
expectationForNotification:
object:
keyValueObservingExpectationForObject:
keyPath:
expectedValue:
-(void)fulfill;
为满足条件的表达式做标记
布尔值检测
XCTAssert/XCTAssertTrue
断言表达式为真,XCTAssert(expression,format...)当expression求值为TRUE时通过;
XCTAssert([imageexists]);
XCTAssertTrue(expression,format...)当expression求值为TRUE时通过;
XCTAssertTure([imageexists]);
XCTAssertFalse
表达式为假,XCTAssertFalse(expression,format...)当expression求值为False时通过;
XCTAssertFalse(!
[imageexists]);
空值检测
XCTAssertNil
表达式的值为空,XCTAssertNil(a1,format...)为空判断,a1为空时通过,反之不通过;
NSArray*array=nil;
XCTAssertNil(array);
XCTAssertNotNil
表达式的值非空,XCTAssertNotNil(a1,format…)不为空判断,a1不为空时通过,反之不通过;
NSArray*array=[NSArrayarray];
XCTAssertNotNil(array);
等式检测
XCTAssertEqual
XCTAssertEqual(a1,a2,format...)判断相等(当a1和a2是C语言标量、结构体或联合体时使用,判断的是变量的地址,如果地址相同则返回TRUE,否则返回NO);
XCTAssertEqual(array,array2,@"
失败时输出"
XCTAssertEqualObjects
XCTAssertEqualObjects(a1,a2,format...)判断相等,[a1isEqual:
a2]值为TRUE时通过,其中一个不为空时,不通过;
XCTAssertEqualObjects(array,array2,@"
XCTAssertEqualWithAccuracy
XCTAssertEqualWithAccuracy(a1,a2,accuracy,format...)判断相等,(double或float类型)提供一个误差范围,当在误差范围(+/-accuracy)以内相等时通过测试;
XCTAssertEquallWithAccuracy(array,array2,@"
不等式检测
XCTAssertNotEqual
XCTAssertNotEqual(a1,a2,format...)判断不等(当a1和a2是C语言标量、结构体或联合体时使用);
XCTAssertNotEqual(array,array2,@"
XCTAssertNotEqualObjects
XCTAssertNotEqualObjects(a1,a2,format...)判断不等,[a1isEqual:
a2]值为False时通过;
XCTAssertNotEqualObjects(array,array2,@"
XCTAssertNotEqualWithAccuracy
XCTAssertNotEqualWithAccuracy(a1,a2,accuracy,format...)判断不等,(double或float类型)提供一个误差范围,当在误差范围以内不等时通过测试;
XCTAssertNotEquallWithAccuracy(array,array2,@"
相对值检测
XCTAssertGreaterThan:
A>
B
XCTAssertGreaterThan(floatB,floatA,@"
FailOutput"
XCTAssertGreaterThanOrEqual:
A≥B
XCTAssertGreaterThanOrEqual(floatB,floatA,@"
XCTAssertLessThan:
A<
XCTAssertLessThan(floatB,floatA,@"
XCTAssertLessThanOrEqual:
A≤B
XCTAssertLessThanOrEqual(floatB,floatA,@"
异常检测
XCTAssertThrows(expression,format...)
异常测试,当expression发生异常时通过;
反之不通过;
XCTAssertThrowsSpecific(expression,specificException,format...)
异常测试,当expression发生specificException异常时通过;
反之发生其他异常或不发生异常均不通过;
XCTAssertThrowsSpecificNamed(expression,specificException,exception_name,format...)
异常测试,当expression发生具体异常、具体异常名称的异常时通过测试,反之不通过;
XCTAssertNoThrow(expression,format…)
异常测试,当expression没有发生异常时通过测试;
XCTAssertNoThrowSpecific(expression,specificException,format...)
异常测试,当expression没有发生具体异常、具体异常名称的异常时通过测试,反之不通过;
XCTAssertNoThrowSpecificNamed(expression,specificException,exception_name,format...)
异常测试,当expression没有发生具体异常、具体异常名称的异常时通过测试,反之不通过。
无条件失败断言
XCTFail
无条件产生一个失败的结果。
XCTFail();
UITesting
XCUIElementsAPI
exists
判断控件对象是否存在。
BOOL类型。
[textFieldexists]
debugDescription
保存某控件的debug信息,这些信息只能用于调试case,NSString类型。
NSLog(@"
%@"
[textFielddebugDescription]);
hittable
BOOL类型的只读属性,表示当前元素能否获取到坐标。
descendantsMatchingType
从该控件下所有子控件中找到符合指定类型的控件,需要传入XCUIElementType(枚举类,定义了iOS中所有可定位的控件)类型的参数,返回包含了XCUIElementType类型的XCUIElementQuery数组。
XCUIElementQuery*textFields=[cellchildrenMatchingType:
XCUIElementTypeTextField];
childrenMatchingType
只从与该控件有直接关系的子控件中找到符合指定类型的控件,需要传入XCUIElementType类型的参数,返回包含了XCUIElementType类型的XCUIElementQuery数组。
XCUIElementQuery*textFields=[celldescendantsMatchingType:
tap
单击
[app.tables.staticTexts[@"
Groceries"
]tap];
doubleTap
双击
[buttondoubletap];
twoFingerTap
双指单击
[apptwoFingerTap];
pressForDuration(duration:
NSTimeInterval)
长按,时间由传入的参数定义,单位为秒
[textFieldpressForDuration:
5.5];
NSTimeInterval,thenDragToElementotherElement:
XCUIElement)
长按拖拽。
在控件上长按后,拖拽到另外一个控件。
传入2个参数:
长按时间和拖拽到目标控件。
5.5,thenDragToElement:
table];
swipeUp/swipeDown/swipeLeft/swipeRight
从下划到上/从上滑到下/从右滑到左/从左滑到右
[appswipeUp];
typeText
输入字符。
需要一个参数:
NSString
[addItemTextFieldtypeText:
Hello"
tapWithNumberOfTaps:
numberOfTouches:
多触摸点及多次点击
[windowstapWithNumberOfTaps:
3numberOfTouches:
2];
pinchWithScale:
velocity:
捏合手势scale=0~1为捏合、>
1为放大,velocity为捏合速度
[windowspinchWithScale:
0.2velocity:
-0.05];
当0<
scale<
1时,velocity必须小于0;
当scale>
1时,velocity必须大于0,time(s)=scale/velocity。
[imgpinchWithScale:
0.5velocity:
0.2];
rotate:
withVelocity:
旋转手势rotate:
要旋转的弧度withVelocity:
每秒要旋转的弧度
Rotate和Velocity必须同号顺时针为正向。
[imgrotate:
2withVelocity:
0.4];
normalizedSliderPosition
只读属性,返回滑块控件中滑块的位置(0~1)
adjustToNormalizedSliderPosition:
尽可能让滑块移动到指定的位置(0-1)
adjustToPickerWheelValue:
输入字符串让选择器显示对应内容,如果没有对应内容,返回Fail
coordinateWithNormalizedOffset:
根据控件的原点坐标和偏移量来确定一个新坐标
[elementcoordinateWithNormalizedOffset:
CGVectorMake(10,10)];
XCUIApplicationAPI
XCTest新加的类,用于做UI测试,代表被测应用,父类为XCUIElement
launch
启动应用。
如果目标应用已运行,首先终止应用,然后再次启动应用。
[applaunch];
terminate
关闭应用。
[appterminate];
launchArguments
数组对象,保存启动参数。
NSArray*args=[applaunchArguments];
for(inti=0;
i<
[argscount];
i++){
arg:
[argsobjectAtIndex:
i]);
launchEnvironment
字典对象,保存启动环境变量
NSDictionary*env=[applaunchEnvironment];
for(idkeyinenv){
NSString*object=[envobjectForKey:
key];
env:
object);
XCUIElementAttributesAPI
协议类,XCUIElement遵守的协议
identifier
字符串类型AccessibilityID
NSString*identifier=[appidentifier];
.frame
控件的矩形区域
CGRectframe=[appframe];
Value
获取元素的原值
idvalue=[appvalue];
placeholderValue
返回元素的占位值
title
标题,String类型
NSString*title=[apptitle];
label
标签值,String类型
NSString*label=[applabel];
elementType
控件类型
XCUIElementType*elementType=[appelementType];
enabled
是否可用,BOOL类型
BOOL*isEnabled=[appisEnabled];
hasFocus
是否具有UI焦点
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- XCTestAPI 文档