appium-mac2-driver 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [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)
+
+
+### Miscellaneous Chores
+
+* fix typos ([#344](https://github.com/appium/appium-mac2-driver/issues/344)) ([3687efa](https://github.com/appium/appium-mac2-driver/commit/3687efa3b43c83e2ec2a3f1414c6fa3b7f7da5c0))
+
 ## [3.0.0](https://github.com/appium/appium-mac2-driver/compare/v2.2.2...v3.0.0) (2025-08-17)
 
 

package/README.md

@@ -83,7 +83,7 @@ Mac2 driver supports the following location strategies:
 
 Name | Description | Speed Ranking | Pseudocode
 --- | --- |  --- | ---
-accessibilityId, id, name | These all strategies are mapped to the same Mac2 driver ByIdentifier lookup strategy. The locator matches the passed value with element's `identifer` attribute case-sensitively. | `⭐⭐⭐⭐⭐` | AppiumBy.accessibilityId("identifier"), By.id("identifier"), By.name("identifier")
+accessibilityId, id, name | These all strategies are mapped to the same Mac2 driver ByIdentifier lookup strategy. The locator matches the passed value with element's `identifier` attribute case-sensitively. | `⭐⭐⭐⭐⭐` | AppiumBy.accessibilityId("identifier"), By.id("identifier"), By.name("identifier")
 className | Class name uses stringified element types for lookup | `⭐⭐⭐⭐⭐` | By.className("XCUIElementTypePopUpButton")
 predicate | Lookup by predicate is natively supported by XCTest and is as fast as previous lookup strategies. This lookup strategy could only use the supported [element attributes](#element-attributes). Unknown attribute names would throw an exception. Check [NSPredicate cheat sheet](https://academy.realm.io/posts/nspredicate-cheatsheet/) for more details on how to build effective and flexible locators. | `⭐⭐⭐⭐⭐` | AppiumBy.iOSNsPredicateString("elementType == 2 AND label BEGINSWITH 'Safari'")
 classChain | This strategy is a combination of Xpath flexibility and fast predicate lookup. Prefer it over Xpath unless there is no other way to build the desired locator. Visit [Class Chain Construction Rules tutorial](https://github.com/facebookarchive/WebDriverAgent/wiki/Class-Chain-Queries-Construction-Rules) to get more knowledge on how to build class chain locators. | `⭐⭐⭐⭐` | AppiumBy.iOSClassChain("**/XCUIElementTypeRuler[$elementType == 72 AND value BEGINSWITH '10'$]")
@@ -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
 

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/IntegrationTests/AMW3CActionsTests.m

@@ -136,7 +136,7 @@
     },
     ],
 
-    // Chain element with singe up action
+    // Chain element with single up action
     @[@{
         @"type": @"pointer",
         @"id": @"finger1",

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIApplication+AMActiveElement.h

@@ -21,7 +21,7 @@ NS_ASSUME_NONNULL_BEGIN
 @interface XCUIApplication (AMActiveElement)
 
 /**
- Retrives the element, which holds the keyboard input focus
+ Retrieves the element, which holds the keyboard input focus
  */
 - (nullable XCUIElement *)am_activeElement;
 

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIApplication+AMSource.h

@@ -21,12 +21,12 @@ NS_ASSUME_NONNULL_BEGIN
 @interface XCUIApplication (AMSource)
 
 /**
- Retrives XML application source representation
+ Retrieves XML application source representation
  */
 - (NSString *)am_xmlRepresentation;
 
 /**
- Retrives description application source representation.
+ Retrieves description application source representation.
  Actually, the value of debugDescription property
  */
 - (NSString *)am_descriptionRepresentation;

package/WebDriverAgentMac/WebDriverAgentLib/Categories/XCUIApplication+FBW3CActions.h

@@ -19,7 +19,7 @@ NS_ASSUME_NONNULL_BEGIN
  Perform complex touch action in scope of the current application.
  
  @param actions Array of dictionaries, whose format is described in W3C spec (https://github.com/jlipps/simple-wd-spec#perform-actions)
- @param elementCache Cached elements mapping for the currrent application. The method assumes all elements are already represented by their actual instances if nil value is set
+ @param elementCache Cached elements mapping for the current application. The method assumes all elements are already represented by their actual instances if nil value is set
  @param error If there is an error, upon return contains an NSError object that describes the problem
  @return YES If the touch action has been successfully performed without errors
  */

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

@@ -23,14 +23,14 @@ NS_ASSUME_NONNULL_BEGIN
 /**
  Retrieves the first match from the query
 
- @returns Matched element instance ot nil if no element is found
+ @returns Matched element instance or nil if no element is found
  */
 - (nullable XCUIElement *)am_firstMatch;
 
 /**
  Retrieves all matches from the query
 
- @returns Matched element instances ot an empty array if no matches are found
+ @returns Matched element instances or an empty array if no matches are found
  */
 - (NSArray<XCUIElement *> *)am_allMatches;
 

package/WebDriverAgentMac/WebDriverAgentLib/Commands/AMWindowCommands.m

@@ -32,21 +32,21 @@
 {
   return [self performClickWithButtonId:@"_XCUI:FullScreenWindow"
                                 request:request
-                           errorMessage:[NSString stringWithFormat:@"%@ window cannot be maximized because the correponding button is not available", request.session.currentApplication.description]];
+                           errorMessage:[NSString stringWithFormat:@"%@ window cannot be maximized because the corresponding button is not available", request.session.currentApplication.description]];
 }
 
 + (id<FBResponsePayload>)handleFullscreenWindow:(FBRouteRequest *)request
 {
   return [self performClickWithButtonId:@"_XCUI:FullScreenWindow"
                                 request:request
-                           errorMessage:[NSString stringWithFormat:@"%@ window cannot be put into fullscreen mode because the correponding button is not available", request.session.currentApplication.description]];
+                           errorMessage:[NSString stringWithFormat:@"%@ window cannot be put into fullscreen mode because the corresponding button is not available", request.session.currentApplication.description]];
 }
 
 + (id<FBResponsePayload>)handleMinimizeWindow:(FBRouteRequest *)request
 {
   return [self performClickWithButtonId:@"_XCUI:MinimizeWindow"
                                 request:request
-                           errorMessage:[NSString stringWithFormat:@"%@ window cannot be minimized because the correponding button is not available", request.session.currentApplication.description]];
+                           errorMessage:[NSString stringWithFormat:@"%@ window cannot be minimized because the corresponding button is not available", request.session.currentApplication.description]];
 }
 
 + (id<FBResponsePayload>)performClickWithButtonId:(NSString *)buttonId

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/Routing/FBExceptions.h

@@ -30,16 +30,16 @@ extern NSString *const FBElementNotVisibleException;
 extern NSString *const FBTimeoutException;
 
 /**
- The exception happends if the cached element does not exist in DOM anymore
+ The exception happens if the cached element does not exist in DOM anymore
  */
 extern NSString *const FBStaleElementException;
 
 /**
- The exception happends if the provided XPath expession cannot be compiled because of a syntax error
+ The exception happens if the provided XPath expression cannot be compiled because of a syntax error
  */
 extern NSString *const FBInvalidXPathException;
 /**
- The exception happends if any internal error is triggered during XPath matching procedure
+ The exception happens if any internal error is triggered during XPath matching procedure
  */
 extern NSString *const FBXPathQueryEvaluationException;
 

package/WebDriverAgentMac/WebDriverAgentLib/Routing/FBResponseJSONPayload.h

@@ -15,7 +15,7 @@
 NS_ASSUME_NONNULL_BEGIN
 
 /**
- Class that represents WebDriverAgent JSON repsonse
+ Class that represents WebDriverAgent JSON response
  */
 @interface FBResponseJSONPayload : NSObject <FBResponsePayload>
 

package/WebDriverAgentMac/WebDriverAgentLib/Routing/FBScreenRecordingRequest.h

@@ -20,7 +20,7 @@ NS_ASSUME_NONNULL_BEGIN
 @property (readonly, nonatomic, nullable) NSNumber *displayID;
 
 /**
- Creates a custom wrapper for a screen recording reqeust
+ Creates a custom wrapper for a screen recording request
 
  @param fps FPS value, see baove
  @param codec Codex value, see above

package/WebDriverAgentMac/WebDriverAgentLib/Routing/FBScreenRecordingRequest.m

@@ -37,7 +37,7 @@
   SEL videoEncodingConstructorSelector = NSSelectorFromString(@"initWithCodec:frameRate:");
   if (![videoEncodingAllocated respondsToSelector:videoEncodingConstructorSelector]) {
     [[[FBErrorBuilder builder]
-      withDescription:@"'initWithCodec:frameRate:' contructor is not found on XCTVideoEncoding class"]
+      withDescription:@"'initWithCodec:frameRate:' constructor is not found on XCTVideoEncoding class"]
      buildError:error];
     return nil;
   }
@@ -69,7 +69,7 @@
   SEL screenRecordingRequestConstructorSelector = NSSelectorFromString(@"initWithScreenID:rect:preferredEncoding:");
   if (![screenRecordingRequestAllocated respondsToSelector:screenRecordingRequestConstructorSelector]) {
     [[[FBErrorBuilder builder]
-      withDescription:@"'initWithScreenID:rect:preferredEncoding:' contructor is not found on XCTScreenRecordingRequest class"]
+      withDescription:@"'initWithScreenID:rect:preferredEncoding:' constructor is not found on XCTScreenRecordingRequest class"]
      buildError:error];
     return nil;
   }

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/AMScreenUtils.h

@@ -22,7 +22,7 @@ NS_ASSUME_NONNULL_BEGIN
 
 /** YES if the corresponding screen is a main screen */
 @property (readonly, nonatomic) BOOL isMain;
-/** The integer indentifier of a screen */
+/** The integer identifier of a screen */
 @property (readonly, nonatomic) long long identifier;
 
 @end

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMSettings.h

@@ -18,7 +18,7 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-/*!Controls elements binding strategy. By default elements are bind by accessiblity identifier */
+/*!Controls elements binding strategy. By default elements are bind by accessibility identifier */
 extern NSString* const AM_BOUND_ELEMENTS_BY_INDEX_SETTING;
 
 /*!Whether to use the default XCTest UI interruptions hanfling (YES by default).

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/AMSnapshotUtils.h

@@ -21,11 +21,11 @@ NS_ASSUME_NONNULL_BEGIN
 @interface AMSnapshotUtils : NSObject
 
 /**
- Retrives the unique snapshot hash. This hash is unique per snapshot's
+ Retrieves the unique snapshot hash. This hash is unique per snapshot's
  accessibility elemnent, which means different snapshots of the same
  element may have equal hashes
 
- @param snapshot snapshot instance to calcluate the hash for
+ @param snapshot snapshot instance to calculate the hash for
  @return The hash value as base64-encoded string
  */
 + (NSString *)hashWithSnapshot:(id)snapshot;

package/WebDriverAgentMac/WebDriverAgentLib/Utilities/FBBaseActionsSynthesizer.h

@@ -23,14 +23,14 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic) double offset;
 
 /**
- Get the name of the corresponding raw action item. This method is expected to be overriden in subclasses.
- 
- @return The corresponding action item key in object's raw JSON reprsentation
+ Get the name of the corresponding raw action item. This method is expected to be overridden in subclasses.
+
+ @return The corresponding action item key in object's raw JSON representation
  */
 + (NSString *)actionName;
 
 /**
- Add the current gesture to XCPointerEventPath instance. This method is expected to be overriden in subclasses.
+ Add the current gesture to XCPointerEventPath instance. This method is expected to be overridden in subclasses.
  
  @param eventPath The destination XCPointerEventPath instance. If nil value is passed then a new XCPointerEventPath instance is going to be created
  @param allItems The existing actions chain to be transformed into event path
@@ -66,7 +66,7 @@ NS_ASSUME_NONNULL_BEGIN
  Calculate absolute gesture position on the screen based on provided element and positionOffset values.
 
  @param element The element instance to perform the gesture on. If element equals to nil then positionOffset is considered as absolute coordinates
- @param positionOffset The actual coordinate offset. If this calue equals to nil then element's hitpoint is taken as gesture position. If element is not nil then this offset is calculated relatively to the top-left cordner of the element's position
+ @param positionOffset The actual coordinate offset. If this value equals to nil then element's hitpoint is taken as gesture position. If element is not nil then this offset is calculated relatively to the top-left cordner of the element's position
  @param error If there is an error, upon return contains an NSError object that describes the problem
  @return Adbsolute gesture position on the screen or nil if the calculation fails (for example, the element is invisible)
  */
@@ -85,7 +85,7 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic) double durationOffset;
 
 /**
- Add a new gesture item to the current chain. The method is expected to be overriden in subclasses.
+ Add a new gesture item to the current chain. The method is expected to be overridden in subclasses.
  
  @param item The actual gesture instance to be added
  */
@@ -113,8 +113,8 @@ NS_ASSUME_NONNULL_BEGIN
 
 /**
  Initializes actions synthesizer. This initializer should be used only by subclasses.
- 
- @param actions The raw actions chain received from request's JSON. The format of this chain is defined by the standard, implemented in the correspoding subclass.
+
+ @param actions The raw actions chain received from request's JSON. The format of this chain is defined by the standard, implemented in the corresponding subclass.
  @param application Current application instance
  @param elementCache Elements cache, which is used to replace elements references in the chain with their instances. We assume the chain already contains element instances if this parameter is set to nil
  @param error If there is an error, upon return contains an NSError object that describes the problem
@@ -126,7 +126,7 @@ NS_ASSUME_NONNULL_BEGIN
                                    error:(NSError **)error;
 
 /**
- Synthesizes XCTest-compatible event record to be performed in the UI. This method is supposed to be overriden by subclasses.
+ Synthesizes XCTest-compatible event record to be performed in the UI. This method is supposed to be overridden by subclasses.
  
  @param error If there is an error, upon return contains an NSError object that describes the problem
  @return The generated event record or nil in case of failure