appium-webdriveragent 17.0.0 → 17.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,13 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ ## [17.0.1](https://github.com/appium/appium-ios/compare/appium-webdriveragent@17.0.0...appium-webdriveragent@17.0.1) (2026-11-12)
7
+
8
+ ### Bug Fixes
9
+
10
+ * **webdriveragent:** preserve detected Safari alert snapshot ([#187](https://github.com/appium/appium-ios/issues/187)) ([a5d3dbb](https://github.com/appium/appium-ios/commit/a5d3dbb9b25fbc5ec5620127e876feae6abed806))
11
+
12
+
6
13
  ## [17.0.0](https://github.com/appium/appium-ios/compare/appium-webdriveragent@16.18.5...appium-webdriveragent@17.0.0) (2026-11-11)
7
14
 
8
15
  ### ⚠ BREAKING CHANGES
@@ -591,6 +591,7 @@
591
591
  715AFAC41FFA2AAF0053896D /* FBScreenTests.m in Sources */ = {isa = PBXBuildFile; fileRef = 715AFAC31FFA2AAF0053896D /* FBScreenTests.m */; };
592
592
  8EB95DF348A9438BBEAB4501 /* FBDisplayGestureTests.m in Sources */ = {isa = PBXBuildFile; fileRef = 8EB95DF348A9438BBEAB4502 /* FBDisplayGestureTests.m */; };
593
593
  715D554B2229891B00524509 /* FBExceptionHandlerTests.m in Sources */ = {isa = PBXBuildFile; fileRef = 715D554A2229891B00524509 /* FBExceptionHandlerTests.m */; };
594
+ 185A00000000000000000002 /* FBAlertSnapshotTests.m in Sources */ = {isa = PBXBuildFile; fileRef = 185A00000000000000000001 /* FBAlertSnapshotTests.m */; };
594
595
  715D5773224DE02E00DA2D99 /* libxml2.tbd in Frameworks */ = {isa = PBXBuildFile; fileRef = 716C9345224D540C004B8542 /* libxml2.tbd */; };
595
596
  715D5774224DE05400DA2D99 /* libxml2.tbd in Frameworks */ = {isa = PBXBuildFile; fileRef = 716C9345224D540C004B8542 /* libxml2.tbd */; };
596
597
  715D5775224DE05C00DA2D99 /* libxml2.tbd in Frameworks */ = {isa = PBXBuildFile; fileRef = 716C9345224D540C004B8542 /* libxml2.tbd */; };
@@ -1637,6 +1638,7 @@
1637
1638
  715AFAC31FFA2AAF0053896D /* FBScreenTests.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = FBScreenTests.m; sourceTree = "<group>"; };
1638
1639
  8EB95DF348A9438BBEAB4502 /* FBDisplayGestureTests.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = FBDisplayGestureTests.m; sourceTree = "<group>"; };
1639
1640
  715D554A2229891B00524509 /* FBExceptionHandlerTests.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = FBExceptionHandlerTests.m; sourceTree = "<group>"; };
1641
+ 185A00000000000000000001 /* FBAlertSnapshotTests.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = FBAlertSnapshotTests.m; sourceTree = "<group>"; };
1640
1642
  71649EC82518C19C0087F212 /* IOSTestSettings.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = IOSTestSettings.xcconfig; sourceTree = "<group>"; };
1641
1643
  716C9342224D53A1004B8542 /* XCTest.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = XCTest.framework; path = Platforms/AppleTVOS.platform/Developer/Library/Frameworks/XCTest.framework; sourceTree = DEVELOPER_DIR; };
1642
1644
  716C9343224D53DF004B8542 /* libAccessibility.tbd */ = {isa = PBXFileReference; lastKnownFileType = "sourcecode.text-based-dylib-definition"; name = libAccessibility.tbd; path = usr/lib/libAccessibility.tbd; sourceTree = SDKROOT; };
@@ -2757,6 +2759,7 @@
2757
2759
  719FF5B81DAD21F5008E0099 /* FBElementUtilitiesTests.m */,
2758
2760
  EE6A892C1D0B2AF40083E92B /* FBErrorBuilderTests.m */,
2759
2761
  715D554A2229891B00524509 /* FBExceptionHandlerTests.m */,
2762
+ 185A00000000000000000001 /* FBAlertSnapshotTests.m */,
2760
2763
  713352FC26CEF31D00523CBC /* FBLRUCacheTests.m */,
2761
2764
  EE18883C1DA663EB00307AA8 /* FBMathUtilsTests.m */,
2762
2765
  718F49C7230844330045FE8B /* FBProtocolHelpersTests.m */,
@@ -4933,6 +4936,7 @@
4933
4936
  EEE16E971D33A25500172525 /* FBConfigurationTests.m in Sources */,
4934
4937
  ADBC39941D0782CD00327304 /* FBElementCacheTests.m in Sources */,
4935
4938
  715D554B2229891B00524509 /* FBExceptionHandlerTests.m in Sources */,
4939
+ 185A00000000000000000002 /* FBAlertSnapshotTests.m in Sources */,
4936
4940
  718F49C8230844330045FE8B /* FBProtocolHelpersTests.m in Sources */,
4937
4941
  719FF5B91DAD21F5008E0099 /* FBElementUtilitiesTests.m in Sources */,
4938
4942
  716E0BD11E917F260087A825 /* FBXMLSafeStringTests.m in Sources */,
@@ -70,8 +70,9 @@
70
70
  // see XCUIApplication+FBAlert.m).
71
71
  - (nullable id<FBXCElementSnapshot>)alertSnapshot
72
72
  {
73
+ // Alert detection may already cache a narrower subtree (e.g. a Safari dialog).
74
+ XCUIElement *alertElement = self.alertElement;
73
75
  if (!self.hasCachedAlertSnapshot) {
74
- XCUIElement *alertElement = self.alertElement;
75
76
  self.cachedAlertSnapshot = nil == alertElement
76
77
  ? nil
77
78
  : (alertElement.fb_cachedSnapshot ?: [alertElement fb_customSnapshot]);
@@ -15,11 +15,11 @@
15
15
  <key>CFBundlePackageType</key>
16
16
  <string>FMWK</string>
17
17
  <key>CFBundleShortVersionString</key>
18
- <string>17.0.0</string>
18
+ <string>17.0.1</string>
19
19
  <key>CFBundleSignature</key>
20
20
  <string>????</string>
21
21
  <key>CFBundleVersion</key>
22
- <string>17.0.0</string>
22
+ <string>17.0.1</string>
23
23
  <key>NSPrincipalClass</key>
24
24
  <string/>
25
25
  </dict>
@@ -0,0 +1,112 @@
1
+ /**
2
+ * Copyright (c) 2015-present, Facebook, Inc.
3
+ * All rights reserved.
4
+ *
5
+ * This source code is licensed under the BSD-style license found in the
6
+ * LICENSE file in the root directory of this source tree.
7
+ */
8
+
9
+ #import <XCTest/XCTest.h>
10
+
11
+ #import "FBAlert.h"
12
+ #import "FBXCElementSnapshot.h"
13
+ #import "XCUIElementDouble.h"
14
+
15
+ @interface FBAlert (SnapshotTests)
16
+ - (id<FBXCElementSnapshot>)alertSnapshot;
17
+ - (XCUIElement *)alertElementFromApplication:(id<FBXCElementSnapshot> *)snapshotOut;
18
+ @end
19
+
20
+ @interface FBAlertSnapshotElementDouble : XCUIElementDouble
21
+ @property (nonatomic) id<FBXCElementSnapshot> cachedSnapshot;
22
+ @property (nonatomic) id<FBXCElementSnapshot> customSnapshot;
23
+ @property (nonatomic) NSUInteger cachedSnapshotCalls;
24
+ @property (nonatomic) NSUInteger customSnapshotCalls;
25
+ @end
26
+
27
+ @implementation FBAlertSnapshotElementDouble
28
+ - (id<FBXCElementSnapshot>)fb_cachedSnapshot
29
+ {
30
+ self.cachedSnapshotCalls++;
31
+ return self.cachedSnapshot;
32
+ }
33
+ - (id)fb_customSnapshot
34
+ {
35
+ self.customSnapshotCalls++;
36
+ return self.customSnapshot;
37
+ }
38
+ @end
39
+
40
+ @interface FBAlertSnapshotDouble : FBAlert
41
+ @property (nonatomic) FBAlertSnapshotElementDouble *detectedElement;
42
+ @property (nonatomic) id<FBXCElementSnapshot> detectedSnapshot;
43
+ @property (nonatomic) NSUInteger detectionCalls;
44
+ @end
45
+
46
+ @implementation FBAlertSnapshotDouble
47
+ - (XCUIElement *)alertElementFromApplication:(id<FBXCElementSnapshot> *)snapshotOut
48
+ {
49
+ self.detectionCalls++;
50
+ *snapshotOut = self.detectedSnapshot;
51
+ return (XCUIElement *)self.detectedElement;
52
+ }
53
+ @end
54
+
55
+ @interface FBAlertSnapshotTests : XCTestCase
56
+ @end
57
+
58
+ @implementation FBAlertSnapshotTests
59
+
60
+ - (void)testFirstSnapshotReadPreservesDetectionSnapshot
61
+ {
62
+ FBAlertSnapshotDouble *alert = [FBAlertSnapshotDouble new];
63
+ alert.detectedElement = [FBAlertSnapshotElementDouble new];
64
+ // Safari detection returns a scroll view element and a separate dialog snapshot.
65
+ // These opaque identities suffice: snapshot retrieval must not inspect either tree.
66
+ alert.detectedSnapshot = (id)[NSObject new];
67
+ alert.detectedElement.cachedSnapshot = (id)[NSObject new];
68
+
69
+ XCTAssertEqual(alert.alertSnapshot, alert.detectedSnapshot);
70
+ XCTAssertEqual(alert.alertSnapshot, alert.detectedSnapshot);
71
+ XCTAssertEqual(alert.detectionCalls, 1u);
72
+ XCTAssertEqual(alert.detectedElement.cachedSnapshotCalls, 0u);
73
+ XCTAssertEqual(alert.detectedElement.customSnapshotCalls, 0u);
74
+ }
75
+
76
+ - (void)testUsesElementCachedSnapshotWhenDetectionDoesNotSupplyOne
77
+ {
78
+ FBAlertSnapshotDouble *alert = [FBAlertSnapshotDouble new];
79
+ alert.detectedElement = [FBAlertSnapshotElementDouble new];
80
+ alert.detectedElement.cachedSnapshot = (id)[NSObject new];
81
+
82
+ XCTAssertEqual(alert.alertSnapshot, alert.detectedElement.cachedSnapshot);
83
+ XCTAssertEqual(alert.alertSnapshot, alert.detectedElement.cachedSnapshot);
84
+ XCTAssertEqual(alert.detectionCalls, 1u);
85
+ XCTAssertEqual(alert.detectedElement.cachedSnapshotCalls, 1u);
86
+ XCTAssertEqual(alert.detectedElement.customSnapshotCalls, 0u);
87
+ }
88
+
89
+ - (void)testTakesCustomSnapshotOnlyOnceWhenNoCachedSnapshotExists
90
+ {
91
+ FBAlertSnapshotDouble *alert = [FBAlertSnapshotDouble new];
92
+ alert.detectedElement = [FBAlertSnapshotElementDouble new];
93
+ alert.detectedElement.customSnapshot = (id)[NSObject new];
94
+
95
+ XCTAssertEqual(alert.alertSnapshot, alert.detectedElement.customSnapshot);
96
+ XCTAssertEqual(alert.alertSnapshot, alert.detectedElement.customSnapshot);
97
+ XCTAssertEqual(alert.detectionCalls, 1u);
98
+ XCTAssertEqual(alert.detectedElement.cachedSnapshotCalls, 1u);
99
+ XCTAssertEqual(alert.detectedElement.customSnapshotCalls, 1u);
100
+ }
101
+
102
+ - (void)testCachesMissingAlert
103
+ {
104
+ FBAlertSnapshotDouble *alert = [FBAlertSnapshotDouble new];
105
+
106
+ XCTAssertNil(alert.alertSnapshot);
107
+ XCTAssertNil(alert.alertSnapshot);
108
+ XCTAssertFalse(alert.isPresent);
109
+ XCTAssertEqual(alert.detectionCalls, 1u);
110
+ }
111
+
112
+ @end
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "appium-webdriveragent",
3
- "version": "17.0.0",
3
+ "version": "17.0.1",
4
4
  "description": "Package bundling WebDriverAgent",
5
5
  "keywords": [
6
6
  "Appium",
@@ -9,7 +9,7 @@
9
9
  "WebDriverAgent",
10
10
  "iOS"
11
11
  ],
12
- "homepage": "https://github.com/appium/appium-ios/tree/main/packages/webdriveragent",
12
+ "homepage": "https://appium.io",
13
13
  "bugs": {
14
14
  "url": "https://github.com/appium/appium-ios/issues"
15
15
  },
@@ -83,5 +83,5 @@
83
83
  "node": "^22.22.2 || ^24.15.0 || >=26.0.0",
84
84
  "npm": ">=10"
85
85
  },
86
- "gitHead": "9c72898744045b9ac9f691af75f50976c59eb208"
86
+ "gitHead": "09b315999d6165e26d34cc9d080846609dacaef5"
87
87
  }