62 lines
1.7 KiB
C
62 lines
1.7 KiB
C
|
/**
|
||
|
|
* Copyright (c) 2015-present, Facebook, Inc.
|
||
|
|
* All rights reserved.
|
||
|
|
*
|
||
|
|
* This source code is licensed under the BSD-style license found in the
|
||
|
|
* LICENSE file in the root directory of this source tree.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#import <Foundation/Foundation.h>
|
||
|
|
|
||
|
|
@class XCUIElement;
|
||
|
|
|
||
|
|
NS_ASSUME_NONNULL_BEGIN
|
||
|
|
|
||
|
|
// This constant defines the size of the element cache, which puts an upper limit
|
||
|
|
// on the amount of elements which can be stored in the cache.
|
||
|
|
// Based on the data in https://github.com/facebook/WebDriverAgent/pull/896, each
|
||
|
|
// element consumes about 100KB of memory; so 1024 elements would consume 100 MB of
|
||
|
|
// memory.
|
||
|
|
extern const int ELEMENT_CACHE_SIZE;
|
||
|
|
|
||
|
|
@interface FBElementCache : NSObject
|
||
|
|
|
||
|
|
/**
|
||
|
|
Stores element in cache
|
||
|
|
|
||
|
|
@param element element to store
|
||
|
|
@return element's uuid or nil in case the element uid cannnot be extracted
|
||
|
|
*/
|
||
|
|
- (nullable NSString *)storeElement:(XCUIElement *)element;
|
||
|
|
|
||
|
|
/**
|
||
|
|
Returns cached element resolved with default snapshot attributes
|
||
|
|
|
||
|
|
@param uuid uuid of element to fetch
|
||
|
|
@return element
|
||
|
|
@throws FBInvalidArgumentException if uuid is nil
|
||
|
|
*/
|
||
|
|
- (XCUIElement *)elementForUUID:(NSString *)uuid;
|
||
|
|
|
||
|
|
/**
|
||
|
|
Returns cached element resolved with default snapshot attributes
|
||
|
|
|
||
|
|
@param uuid uuid of element to fetch
|
||
|
|
@param checkStaleness Whether to throw FBStaleElementException if the found element is not present in DOM anymore
|
||
|
|
@return element
|
||
|
|
@throws FBStaleElementException if `checkStaleness` is enabled
|
||
|
|
@throws FBInvalidArgumentException if uuid is nil
|
||
|
|
*/
|
||
|
|
- (XCUIElement *)elementForUUID:(NSString *)uuid checkStaleness:(BOOL)checkStaleness;
|
||
|
|
|
||
|
|
/**
|
||
|
|
Checks element existence in the cache
|
||
|
|
|
||
|
|
@returns YES if the element with the given UUID is present in cache
|
||
|
|
*/
|
||
|
|
- (BOOL)hasElementWithUUID:(nullable NSString *)uuid;
|
||
|
|
|
||
|
|
@end
|
||
|
|
|
||
|
|
NS_ASSUME_NONNULL_END
|