初始化提交

WebDriverAgentLib/Routing/FBElementUtils.h

@@ -0,0 +1,76 @@
+/**
+ * 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>
+#import <WebDriverAgentLib/FBElement.h>
+
+@protocol FBXCAccessibilityElement;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*! Notification used to notify about unknown attribute name */
+extern NSString *const FBUnknownAttributeException;
+
+@interface FBElementUtils : NSObject
+
+/**
+ Returns property name defined by FBElement protocol for the given WebDriver Spec property name.
+ Check the FBElement protocol to get list of supported attributes.
+ This method also supports shortcuts, like wdName == name, wdValue == value.
+ In case the corresponding attribute has a getter defined then the name of the getter witll be returned instead,
+ which makes this method compatible with KVO lookup
+ 
+ @param name WebDriver Spec property name
+ @return the corresponding property name
+ @throws FBUnknownAttributeException if there is no matching attribute defined in FBElement protocol
+ */
++ (NSString *)wdAttributeNameForAttributeName:(NSString *)name;
+
+/**
+ Collects all the unique element types from an array of elements.
+ 
+ @param elements array of elements
+ @return set of unique element types (XCUIElementType items) or an empty set in case the input is empty
+ */
++ (NSSet<NSNumber *> *)uniqueElementTypesWithElements:(NSArray<id<FBElement>> *)elements;
+
+/**
+ Returns mapping of all possible FBElement protocol properties aliases
+ 
+ @return dictionary of matching property aliases with their real names as values or getter method names if exist
+ for KVO lookup
+ */
++ (NSDictionary<NSString *, NSString *> *)wdAttributeNamesMapping;
+
+/**
+ Gets the unique identifier of the particular XCAccessibilityElement instance in form of UUIDv4.
+ 
+ @param element accessiblity element instance
+ @return the unique element identifier or nil if it cannot be retrieved
+ */
++ (nullable NSString *)uidWithAccessibilityElement:(id<FBXCAccessibilityElement>)element;
+
+/**
+ Gets the unique identifier of the particular XCAccessibilityElement instance.
+ 
+ @param element accessiblity element instance
+ @return the unique element identifier or nil if it cannot be retrieved
+ */
++ (unsigned long long)idWithAccessibilityElement:(id<FBXCAccessibilityElement>)element;
+
+/**
+ Retrieves the list of required instance methods of the given protocol
+
+ @param protocol target protocol reference
+ @return set of selector names
+ */
++ (NSSet<NSString *> *)selectorNamesWithProtocol:(Protocol *)protocol;
+
+@end
+
+NS_ASSUME_NONNULL_END