appium-mac2-driver 3.0.1 → 3.2.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [3.2.0](https://github.com/appium/appium-mac2-driver/compare/v3.1.0...v3.2.0) (2025-11-11)
+
+
+### Features
+
+* Add a setting that allows to fetch full element text ([#347](https://github.com/appium/appium-mac2-driver/issues/347)) ([a8b9e7e](https://github.com/appium/appium-mac2-driver/commit/a8b9e7ee1c0b576c04eaafb8af0d8649330ffc3b))
+
+## [3.1.0](https://github.com/appium/appium-mac2-driver/compare/v3.0.1...v3.1.0) (2025-10-01)
+
+
+### Features
+
+* Add clipboard support ([#346](https://github.com/appium/appium-mac2-driver/issues/346)) ([a3652fd](https://github.com/appium/appium-mac2-driver/commit/a3652fd2e29c68a30f677200ad8a2dd9148898d8))
+
 ## [3.0.1](https://github.com/appium/appium-mac2-driver/compare/v3.0.0...v3.0.1) (2025-09-28)
 
 

package/README.md

@@ -702,6 +702,32 @@ Name | Type | Description | Example
 id | number | Display identifier | 12345
 isMain | boolean | Is `true` if the display is configured as a main system display | false
 
+### macos: setClipboard
+
+Set the macOS clipboard content as base64-encoded string. The existing clipboard content (if present) will be cleared.
+
+#### Arguments
+
+Name | Type | Required | Description | Example
+--- | --- | --- | --- | ---
+content | string | yes | The content to be set as base64 encoded string | hello
+contentType | string | no | The type of the content to set. Only `plaintext` (default), `image` and `url` are supported. If set to `url`, then `content` must be a valid URL. If set to `image`, then `content` must contain a valid PNG or TIFF image payload. | url
+
+### macos: getClipboard
+
+Get the macOS clipboard content as base64-encoded string.
+
+#### Arguments
+
+Name | Type | Required | Description | Example
+--- | --- | --- | --- | ---
+contentType | string | no | The type of the content to get. Only `plaintext` (default), `image` and `url` are supported. | image
+
+#### Returns
+
+The actual clipboard content encoded into base64 string. An empty string is returned if the clipboard
+contains no data for the given content type.
+
 
 ## Application Under Test Concept
 
@@ -823,6 +849,7 @@ Name | Type | Description
 --- | --- | ---
 boundElementsByIndex | boolean | Whether to use elements binding by index (`true`) or by accessibility identifier (the default setting, `false`). It makes sense to switch the binding strategy to workaround stale element reference errors containing `Identity Binding` text in their descriptions. See the corresponding [Stack Overflow discussion](https://stackoverflow.com/questions/49307513/meaning-of-allelementsboundbyaccessibilityelement) to know more details on the difference between these two binding strategies.
 useDefaultUiInterruptionsHandling | boolean | Whether to use the default XCTest UI interruptions handling (`true`, the default setting) or to disable it for the [Application Under Test](#application-under-test-concept) (`false`). It makes sense to disable the default handler if it is necessary to validate the interrupting element's presence in your test or do some other actions on it rather than just closing the view implicitly. Check [this WWDC presentation](https://developer.apple.com/videos/play/wwdc2020/10220/) from Apple to get more details on the UI interruptions handling.
+fetchFullText | boolean | Whether to use custom snapshotting mechanism to fetch full element's text payload instead of the first 512 chars. By default, this setting is set to false, which makes the driver to use the standard XCTest's snapshotting mechanism. It's fast, but may also cut long textual payloads of various UI element's in order to optimize internal UI hierarchy snapshotting performance. If the performance is less important for you that the ability to validate full element's text then consider enabling this setting while calling [Get Element Text](https://www.w3.org/TR/webdriver1/#dfn-get-element-text) API.
 
 
 ## Scripts

package/WebDriverAgentMac/IntegrationTests/AMEditElementTests.m

@@ -38,8 +38,7 @@
 
 - (void)testSendingTextIntoNonFocusedEdit
 {
-  NSPredicate *predicate = [NSPredicate predicateWithFormat:@"placeholderValue.length == 0"];
-  XCUIElement *edit = [self.testedApplication.textFields matchingPredicate:predicate].firstMatch;
+  XCUIElement *edit = self.testedApplication.textFields.firstMatch;
   NSString *text = @"yolo😎";
   [edit am_setValue:text];
   XCTAssertTrue(edit.am_hasKeyboardInputFocus);
@@ -50,8 +49,7 @@
 
 - (void)testSendingTextIntoNonFocusedEditWithPlaceholderText
 {
-  NSPredicate *predicate = [NSPredicate predicateWithFormat:@"placeholderValue.length > 0"];
-  XCUIElement *edit = [self.testedApplication.textFields matchingPredicate:predicate].firstMatch;
+  XCUIElement *edit = self.testedApplication.textFields.firstMatch;
   NSString *text = @"yolo😎";
   [edit am_setValue:text];
   XCTAssertTrue(edit.am_hasKeyboardInputFocus);

package/WebDriverAgentMac/IntegrationTests/AMPasteboardTests.m

@@ -0,0 +1,111 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * 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.
+ */
+
+#import <XCTest/XCTest.h>
+
+#import "AMIntegrationTestCase.h"
+#import "AMPasteboard.h"
+
+@interface AMPasteboardTests : AMIntegrationTestCase
+@end
+
+NSData *dataFromImage(NSImage *image) {
+  if (!image) return nil;
+
+  NSSize size = [image size];
+  NSBitmapImageRep *bitmapRep = [[NSBitmapImageRep alloc]
+                                 initWithBitmapDataPlanes:NULL
+                                 pixelsWide:size.width
+                                 pixelsHigh:size.height
+                                 bitsPerSample:8
+                                 samplesPerPixel:4
+                                 hasAlpha:YES
+                                 isPlanar:NO
+                                 colorSpaceName:NSCalibratedRGBColorSpace
+                                 bytesPerRow:0
+                                 bitsPerPixel:0];
+  if (!bitmapRep) return nil;
+
+  NSGraphicsContext *context = [NSGraphicsContext graphicsContextWithBitmapImageRep:bitmapRep];
+  if (!context) return nil;
+
+  [NSGraphicsContext saveGraphicsState];
+  [NSGraphicsContext setCurrentContext:context];
+  [image drawInRect:NSMakeRect(0, 0, size.width, size.height)
+           fromRect:NSZeroRect
+          operation:NSCompositingOperationCopy
+           fraction:1.0];
+  [NSGraphicsContext restoreGraphicsState];
+
+  return [bitmapRep representationUsingType:NSBitmapImageFileTypePNG properties:@{}];
+}
+
+
+@implementation AMPasteboardTests
+
+- (void)testPasteboardPlaintex
+{
+  NSError *error;
+  NSString *expected = @"test";
+  XCTAssertTrue([AMPasteboard setData:[expected dataUsingEncoding:NSUTF8StringEncoding]
+                              forType:@"plaintext"
+                                error:&error]);
+  XCTAssertNil(error);
+  NSData *actual = [AMPasteboard dataForType:@"plaintext" error:&error];
+  XCTAssertNotNil(actual);
+  XCTAssertNil(error);
+  XCTAssertEqualObjects([[NSString alloc] initWithData:actual encoding:NSUTF8StringEncoding], expected);
+}
+
+- (void)testPasteboardUrl
+{
+  NSError *error;
+  NSString *expected = @"https://appium.io";
+  XCTAssertTrue([AMPasteboard setData:[expected dataUsingEncoding:NSUTF8StringEncoding]
+                              forType:@"url"
+                                error:&error]);
+  XCTAssertNil(error);
+  NSData *actual = [AMPasteboard dataForType:@"url" error:&error];
+  XCTAssertNotNil(actual);
+  XCTAssertNil(error);
+  XCTAssertEqualObjects([[NSString alloc] initWithData:actual encoding:NSUTF8StringEncoding], expected);
+}
+
+- (void)testPasteboardImage
+{
+  NSImage *image = [[NSImage alloc] initWithSize:NSMakeSize(1, 1)];
+  [image lockFocus];
+  [[NSColor clearColor] setFill];
+  NSRectFill(NSMakeRect(0, 0, 1, 1));
+  [image unlockFocus];
+
+  NSData *expected = dataFromImage(image);
+  if (nil == expected) {
+    XCTFail(@"imageData cannot be nil");
+  }
+
+  NSError *error;
+  XCTAssertTrue([AMPasteboard setData:expected
+                              forType:@"image"
+                                error:&error]);
+  XCTAssertNil(error);
+  NSData *actual = [AMPasteboard dataForType:@"image" error:&error];
+  XCTAssertNotNil(actual);
+  XCTAssertNil(error);
+  XCTAssertEqualObjects(actual, expected);
+}
+
+@end

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIElement+AMAttributes.h

@@ -34,9 +34,11 @@ NS_ASSUME_NONNULL_BEGIN
 - (NSDictionary<NSString *, NSNumber *> *)am_rect;
 
 /**
- Element text
+ Element text. If no text is found then an empty string is returned.
+
+ @throws Error if `fetchFullText` setting is enabled and there was an error while fetching the snapshot
  */
-- (nullable NSString *)am_text;
+- (NSString *)am_text;
 
 /**
  Element type represented as string

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIElement+AMAttributes.m

@@ -17,10 +17,12 @@
 #import "XCUIElement+AMAttributes.h"
 
 #import "AMGeometryUtils.h"
+#import "FBConfiguration.h"
 #import "FBElementTypeTransformer.h"
 #import "FBElementUtils.h"
 #import "FBExceptions.h"
 #import "FBMacros.h"
+#import "XCUIElementQuery+AMHelpers.h"
 
 @implementation XCUIElement (AMAttributes)
 
@@ -64,23 +66,20 @@
 
 - (NSString *)am_text
 {
-  NSString *value = [FBElementUtils stringValueWithValue:self.value];
-  if (nil != value && value.length > 0) {
-    return value;
+  if (!FBConfiguration.sharedConfiguration.fetchFullText) {
+    return [self am_textWithSource:self];
   }
-  NSString *label = self.label;
-  if (nil != label && label.length > 0) {
-    return label;
-  }
-  NSString *placeholderValue = self.placeholderValue;
-  if (nil != placeholderValue && placeholderValue.length > 0) {
-    return placeholderValue;
-  }
-  NSString *title = self.title;
-  if (nil != title && title.length > 0) {
-    return title;
+
+  NSError *error;
+  XCUIElementQuery *query = [self valueForKey:@"query"];
+  id<XCUIElementAttributes> snapshot = [query am_uniqueSnapshotWithError:&error];
+  if (nil != snapshot) {
+    return [self am_textWithSource:snapshot];
   }
-  return @"";
+
+  NSString *reason = [NSString stringWithFormat:@"Cannot extract the full text of '%@' element. Original error: %@",
+    self.description, error.description];
+  @throw [NSException exceptionWithName:FBInvalidElementStateException reason:reason userInfo:@{}];
 }
 
 - (NSString *)am_type
@@ -94,4 +93,20 @@
   return [predicate evaluateWithObject:self];
 }
 
+- (NSString *)am_textWithSource:(id<XCUIElementAttributes>)source
+{
+  NSArray<NSString *> *candidates = @[
+    [FBElementUtils stringValueWithValue:source.value],
+    source.label,
+    source.placeholderValue,
+    source.title
+  ];
+  for (NSString *text in candidates) {
+    if (nil != text && text.length > 0) {
+      return text;
+    }
+  }
+  return @"";
+}
+
 @end

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIElementQuery+AMHelpers.h

@@ -34,6 +34,14 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (NSArray<XCUIElement *> *)am_allMatches;
 
+/**
+ Returns single unique matching snapshot for the given query
+
+ @param error The error instance if there was a failure while retrieveing the snapshot
+ @returns The unqiue snapshot or nil if the element is stale
+ */
+- (nullable id<XCUIElementSnapshot>)am_uniqueSnapshotWithError:(NSError **)error;
+
 @end
 
 NS_ASSUME_NONNULL_END

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIElementQuery+AMHelpers.m

@@ -32,4 +32,21 @@
     : self.allElementsBoundByAccessibilityElement;
 }
 
+- (id<XCUIElementSnapshot>)am_uniqueSnapshotWithError:(NSError **)error
+{
+  SEL selector = NSSelectorFromString(@"uniqueMatchingSnapshotWithError:");
+  NSMethodSignature *signature = [self methodSignatureForSelector:selector];
+  NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:signature];
+  invocation.target = self;
+  invocation.selector = selector;
+
+  [invocation setArgument:&error atIndex:2]; // index 0 = self, 1 = _cmd, 2 = first real argument
+
+  [invocation invoke];
+
+  __unsafe_unretained id returnValue = nil;
+  [invocation getReturnValue:&returnValue];
+  return returnValue;
+}
+
 @end

package/WebDriverAgentMac/WebDriverAgentLib/Commands/FBCustomCommands.m

@@ -9,6 +9,7 @@
 
 #import "FBCustomCommands.h"
 
+#import "AMPasteboard.h"
 #import "FBResponsePayload.h"
 #import "FBRoute.h"
 #import "FBRouteRequest.h"
@@ -21,6 +22,10 @@
   return
   @[
     [[FBRoute POST:@"/timeouts"] respondWithTarget:self action:@selector(handleTimeouts:)],
+    [[FBRoute POST:@"/wda/setPasteboard"] respondWithTarget:self action:@selector(handleSetPasteboard:)],
+    [[FBRoute POST:@"/wda/setPasteboard"].withoutSession respondWithTarget:self action:@selector(handleSetPasteboard:)],
+    [[FBRoute POST:@"/wda/getPasteboard"] respondWithTarget:self action:@selector(handleGetPasteboard:)],
+    [[FBRoute POST:@"/wda/getPasteboard"].withoutSession respondWithTarget:self action:@selector(handleGetPasteboard:)],
     [[FBRoute OPTIONS:@"/*"].withoutSession respondWithTarget:self action:@selector(handlePingCommand:)],
   ];
 }
@@ -34,6 +39,34 @@
   return FBResponseWithOK();
 }
 
++ (id<FBResponsePayload>)handleSetPasteboard:(FBRouteRequest *)request
+{
+  NSString *contentType = request.arguments[@"contentType"] ?: @"plaintext";
+  NSData *content = [[NSData alloc] initWithBase64EncodedString:(NSString *)request.arguments[@"content"]
+                                                        options:NSDataBase64DecodingIgnoreUnknownCharacters];
+  if (nil == content) {
+    return FBResponseWithStatus([FBCommandStatus
+                                 invalidArgumentErrorWithMessage:@"Cannot decode the pasteboard content from base64"
+                                 traceback:nil]);
+  }
+  NSError *error;
+  if (![AMPasteboard setData:content forType:contentType error:&error]) {
+    return FBResponseWithUnknownError(error);
+  }
+  return FBResponseWithOK();
+}
+
++ (id<FBResponsePayload>)handleGetPasteboard:(FBRouteRequest *)request
+{
+  NSString *contentType = request.arguments[@"contentType"] ?: @"plaintext";
+  NSError *error;
+  id result = [AMPasteboard dataForType:contentType error:&error];
+  if (nil == result) {
+    return FBResponseWithUnknownError(error);
+  }
+  return FBResponseWithObject([result base64EncodedStringWithOptions:0]);
+}
+
 + (id<FBResponsePayload>)handlePingCommand:(FBRouteRequest *)request
 {
   return FBResponseWithOK();

package/WebDriverAgentMac/WebDriverAgentLib/Commands/FBSessionCommands.m

@@ -237,6 +237,7 @@ const static NSString *CAPABILITIES_KEY = @"capabilities";
     @{
       AM_BOUND_ELEMENTS_BY_INDEX_SETTING: @(FBSession.activeSession.boundElementsByIndex),
       AM_USE_DEFAULT_UI_INTERRUPTIONS_HANDLING_SETTING: @(!application.am_doesNotHandleUIInterruptions),
+      AM_FETCH_FULL_TEXT: @(FBConfiguration.sharedConfiguration.fetchFullText),
     }
   );
 }
@@ -252,6 +253,9 @@ const static NSString *CAPABILITIES_KEY = @"capabilities";
     XCUIApplication *application = FBSession.activeSession.currentApplication;
     application.am_doesNotHandleUIInterruptions = ![[settings objectForKey:AM_USE_DEFAULT_UI_INTERRUPTIONS_HANDLING_SETTING] boolValue];
   }
+  if (nil != [settings objectForKey:AM_FETCH_FULL_TEXT]) {
+    FBConfiguration.sharedConfiguration.fetchFullText = [settings objectForKey:AM_FETCH_FULL_TEXT];
+  }
 
   return [self handleGetSettings:request];
 }

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMPasteboard.h

@@ -0,0 +1,47 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * 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.
+ */
+
+
+#import <XCTest/XCTest.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface AMPasteboard : NSObject
+
+/**
+ Sets data to the general pasteboard
+
+ @param data base64-encoded string containing the data chunk which is going to be written to the pasteboard
+ @param type one of the possible data types to set: plaintext, url, image
+ @param error If there is an error, upon return contains an NSError object that describes the problem
+ @return YES if the operation was successful
+ */
++ (BOOL)setData:(NSData *)data forType:(NSString *)type error:(NSError **)error;
+
+/**
+ Gets the data contained in the general pasteboard
+
+ @param type one of the possible data types to get: plaintext, url, image
+ @param error If there is an error, upon return contains an NSError object that describes the problem
+ @return NSData object, containing the pasteboard content or an empty string if the pasteboard is empty.
+ nil is returned if there was an error while getting the data from the pasteboard
+ */
++ (nullable NSData *)dataForType:(NSString *)type error:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END
+

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMPasteboard.m

@@ -0,0 +1,128 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * 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.
+ */
+
+
+#import "AMPasteboard.h"
+
+#import <mach/mach_time.h>
+#import "FBErrorBuilder.h"
+#import "FBMacros.h"
+
+
+@implementation AMPasteboard
+
++ (BOOL)setData:(NSData *)data forType:(NSString *)type error:(NSError **)error
+{
+  NSPasteboard *pb = NSPasteboard.generalPasteboard;
+  if ([type.lowercaseString isEqualToString:@"plaintext"]) {
+    [pb clearContents];
+    if (![pb setString:[[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]
+               forType:NSPasteboardTypeString]) {
+      NSString *description = @"Failed to copy string to the clipboard";
+      if (error) {
+        *error = [[FBErrorBuilder.builder withDescription:description] build];
+      }
+      return NO;
+    }
+  } else if ([type.lowercaseString isEqualToString:@"image"]) {
+    NSImage *image = [[NSImage alloc] initWithData:data];
+    if (nil == image) {
+      NSString *description = @"No image can be parsed from the given pasteboard data";
+      if (error) {
+        *error = [[FBErrorBuilder.builder withDescription:description] build];
+      }
+      return NO;
+    }
+    [pb clearContents];
+    if (![pb writeObjects:@[image]]) {
+      NSString *description = @"Failed to copy image to the clipboard";
+      if (error) {
+        *error = [[FBErrorBuilder.builder withDescription:description] build];
+      }
+      return NO;
+    }
+  } else if ([type.lowercaseString isEqualToString:@"url"]) {
+    NSString *urlString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+    NSURL *url = [[NSURL alloc] initWithString:urlString];
+    if (nil == url) {
+      NSString *description = @"No URL can be parsed from the given data";
+      if (error) {
+        *error = [[FBErrorBuilder.builder withDescription:description] build];
+      }
+      return NO;
+    }
+    [pb clearContents];
+    if (![pb setString:[url absoluteString] forType:NSPasteboardTypeURL]) {
+      NSString *description = @"Failed to copy URL to the clipboard";
+      if (error) {
+        *error = [[FBErrorBuilder.builder withDescription:description] build];
+      }
+      return NO;
+    }
+  } else {
+    NSString *description = [NSString stringWithFormat:@"Unsupported content type: %@", type];
+    if (error) {
+      *error = [[FBErrorBuilder.builder withDescription:description] build];
+    }
+    return NO;
+  }
+  return YES;
+}
+
++ (NSData *)dataForType:(NSString *)type error:(NSError **)error
+{
+  NSPasteboard *pb = NSPasteboard.generalPasteboard;
+  if ([type.lowercaseString isEqualToString:@"plaintext"]) {
+    if ([pb.types containsObject:NSPasteboardTypeString]) {
+      NSString* result = [pb stringForType:NSPasteboardTypeString];
+      return [result dataUsingEncoding:NSUTF8StringEncoding];
+    }
+  } else if ([type.lowercaseString isEqualToString:@"image"]) {
+    NSData *imageData = nil;
+
+    for (NSPasteboardType pbType in @[NSPasteboardTypePNG, NSPasteboardTypeTIFF]) {
+      if ([pb.types containsObject:pbType]) {
+        imageData = [pb dataForType:pbType];
+        break;
+      }
+    }
+
+    if (nil != imageData) {
+      NSImage *image = [[NSImage alloc] initWithData:imageData];
+      if (nil != image) {
+        NSArray *reps = [image representations];
+        if ([reps count] > 0 && [reps[0] isKindOfClass:[NSBitmapImageRep class]]) {
+          NSBitmapImageRep *bitmapRep = (NSBitmapImageRep *)reps[0];
+          return [bitmapRep representationUsingType:NSBitmapImageFileTypePNG properties:@{}];
+        }
+      }
+    }
+  } else if ([type.lowercaseString isEqualToString:@"url"]) {
+    if ([pb.types containsObject:NSPasteboardTypeURL]) {
+      NSString* result = [pb stringForType:NSPasteboardTypeURL];
+      return [result dataUsingEncoding:NSUTF8StringEncoding];
+    }
+  } else {
+    NSString *description = [NSString stringWithFormat:@"Unsupported content type: %@", type];
+    if (error) {
+      *error = [[FBErrorBuilder.builder withDescription:description] build];
+    }
+    return nil;
+  }
+  return [@"" dataUsingEncoding:NSUTF8StringEncoding];
+}
+
+@end

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMSettings.h

@@ -25,4 +25,7 @@ extern NSString* const AM_BOUND_ELEMENTS_BY_INDEX_SETTING;
  See https://developer.apple.com/videos/play/wwdc2020/10220/ for more details  */
 extern NSString* const AM_USE_DEFAULT_UI_INTERRUPTIONS_HANDLING_SETTING;
 
+/*! Whether to use custom snapshotting mechanism to fetch full element's text payload instead of the first 512 chars  */
+extern NSString* const AM_FETCH_FULL_TEXT;
+
 NS_ASSUME_NONNULL_END

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMSettings.m

@@ -17,5 +17,5 @@
 #import "AMSettings.h"
 
 NSString* const AM_BOUND_ELEMENTS_BY_INDEX_SETTING = @"boundElementsByIndex";
-
 NSString* const AM_USE_DEFAULT_UI_INTERRUPTIONS_HANDLING_SETTING = @"useDefaultUiInterruptionsHandling";
+NSString* const AM_FETCH_FULL_TEXT = @"fetchFullText";

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/FBConfiguration.h

@@ -30,6 +30,9 @@ NS_ASSUME_NONNULL_BEGIN
 /*! Enables XCTest automated screen recordings taking in Xcode 15+ */
 @property BOOL automaticScreenRecordings;
 
+/*! Whether to use custom snapshotting mechanism to fetch full element's text payload instead of the first 512 chars  */
+@property BOOL fetchFullText;
+
 /**
  The range of ports that the HTTP Server should attempt to bind on launch
  */

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/FBConfiguration.m

@@ -11,6 +11,7 @@
 
 static NSUInteger const DefaultStartingPort = 10100;
 static NSUInteger const DefaultPortRange = 100;
+static BOOL FBFetchFullText = NO;
 
 @implementation FBConfiguration
 
@@ -75,6 +76,16 @@ static FBConfiguration *instance;
                                           forKey:@"DisableDiagnosticScreenRecordings"];
 }
 
+- (BOOL)fetchFullText
+{
+  return FBFetchFullText;
+}
+
+- (void)setFetchFullText:(BOOL)fetchFullText
+{
+  FBFetchFullText = fetchFullText;
+}
+
 - (NSRange)bindingPortRange
 {
   // 'WebDriverAgent --port 8080' can be passed via the arguments to the process