@sapui5/sap.fe.test 1.101.0 → 1.103.0

package/src/sap/fe/test/api/CollaborationAPI.js

@@ -0,0 +1,215 @@
+/*!
+ * SAP UI development toolkit for HTML5 (SAPUI5)
+ *      (c) Copyright 2009-2021 SAP SE. All rights reserved
+ */
+sap.ui.define(["sap/base/Log", "sap/fe/core/controllerextensions/collaboration/ActivityBase", "sap/fe/core/controllerextensions/collaboration/CollaborationCommon", "sap/fe/core/controllerextensions/editFlow/draft", "sap/ui/model/json/JSONModel"], function (Log, ActivityBase, CollaborationCommon, draft, JSONModel) {
+  "use strict";
+
+  var Activity = CollaborationCommon.Activity;
+  var initializeCollaboration = ActivityBase.initializeCollaboration;
+  var endCollaboration = ActivityBase.endCollaboration;
+  var broadcastCollaborationMessage = ActivityBase.broadcastCollaborationMessage;
+
+  var CollaborationAPI = {
+    _lastReceivedMessage: undefined,
+    _rootPath: "",
+    _oModel: undefined,
+    _lockedPropertyPath: "",
+    _internalModel: undefined,
+
+    /**
+     * Open an existing collaborative draft with a new user, and creates a 'ghost client' for this user.
+     *
+     * @param oContext The context of the collaborative draft
+     * @param userID The ID of the user
+     * @param userName The name of the user
+     */
+    enterDraft: function (oContext, userID, userName) {
+      var webSocketBaseURL = oContext.getModel().getMetaModel().getObject("/@com.sap.vocabularies.Common.v1.WebSocketBaseURL");
+
+      if (!webSocketBaseURL) {
+        Log.error("Cannot find WebSocketBaseURL annotation");
+        return;
+      }
+
+      var sDraftUUID = oContext.getProperty("DraftAdministrativeData/DraftUUID");
+      this._internalModel = new JSONModel({});
+      initializeCollaboration({
+        id: userID,
+        name: userName,
+        initialName: userName
+      }, webSocketBaseURL, sDraftUUID, this._internalModel, this._onMessageReceived.bind(this), true);
+      this._rootPath = oContext.getPath();
+      this._oModel = oContext.getModel();
+    },
+
+    /**
+     * Checks if the ghost client has revieved a given message.
+     *
+     * @param message The message content to be looked for
+     * @returns True if the last recieved message matches the content
+     */
+    checkReceived: function (message) {
+      if (!this._lastReceivedMessage) {
+        return false;
+      }
+
+      var found = (!message.userID || message.userID === this._lastReceivedMessage.userID) && (!message.userAction || message.userAction === this._lastReceivedMessage.userAction) && (!message.clientContent || message.clientContent === this._lastReceivedMessage.clientContent);
+      this._lastReceivedMessage = undefined; // reset history to avoid finding the same message twice
+
+      return found;
+    },
+
+    /**
+     * Closes the ghost client and removes the user from the collaborative draft.
+     */
+    leaveDraft: function () {
+      if (this._internalModel) {
+        endCollaboration(this._internalModel);
+
+        this._internalModel.destroy();
+
+        this._internalModel = undefined;
+      }
+    },
+
+    /**
+     * Simulates that the user starts typing in an input (live change).
+     *
+     * @param sPropertyPath The path of the property being modified
+     */
+    startLiveChange: function (sPropertyPath) {
+      if (this._internalModel) {
+        if (this._lockedPropertyPath) {
+          // Unlock previous property path
+          this.undoChange();
+        }
+
+        this._lockedPropertyPath = sPropertyPath;
+        broadcastCollaborationMessage(Activity.LiveChange, "".concat(this._rootPath, "/").concat(sPropertyPath), this._internalModel);
+      }
+    },
+
+    /**
+     * Simulates that the user has modified a property.
+     *
+     * @param sPropertyPath The path of the property being modified
+     * @param value The new value of the property being modified
+     */
+    updatePropertyValue: function (sPropertyPath, value) {
+      var _this = this;
+
+      if (this._internalModel) {
+        if (this._lockedPropertyPath !== sPropertyPath) {
+          this.startLiveChange(sPropertyPath);
+        }
+
+        var oContextBinding = this._oModel.bindContext(this._rootPath, undefined, {
+          $$patchWithoutSideEffects: true,
+          $$groupId: "$auto",
+          $$updateGroupId: "$auto"
+        });
+
+        var oPropertyBinding = this._oModel.bindProperty(sPropertyPath, oContextBinding.getBoundContext());
+
+        oPropertyBinding.requestValue().then(function () {
+          oPropertyBinding.setValue(value);
+          oContextBinding.attachEventOnce("patchCompleted", function () {
+            broadcastCollaborationMessage(Activity.Change, "".concat(_this._rootPath, "/").concat(sPropertyPath), _this._internalModel);
+            _this._lockedPropertyPath = "";
+          });
+        }).catch(function (err) {
+          Log.error(err);
+        });
+      }
+    },
+
+    /**
+     * Simulates that the user did an 'undo' (to be called after startLiveChange).
+     */
+    undoChange: function () {
+      if (this._lockedPropertyPath) {
+        broadcastCollaborationMessage(Activity.Undo, "".concat(this._rootPath, "/").concat(this._lockedPropertyPath), this._internalModel);
+        this._lockedPropertyPath = "";
+      }
+    },
+
+    /**
+     * Simulates that the user has discarded the draft.
+     */
+    discardDraft: function () {
+      var _this2 = this;
+
+      if (this._internalModel) {
+        var draftContext = this._getDraftContext();
+
+        draftContext.requestProperty("IsActiveEntity").then(function () {
+          draft.deleteDraft(draftContext);
+        }).then(function () {
+          broadcastCollaborationMessage(Activity.Discard, _this2._rootPath.replace("IsActiveEntity=false", "IsActiveEntity=true"), _this2._internalModel);
+
+          _this2._internalModel.destroy();
+
+          _this2._internalModel = undefined;
+        }).catch(function (err) {
+          Log.error(err);
+        });
+      }
+    },
+
+    /**
+     * Simulates that the user has deleted the draft.
+     */
+    deleteDraft: function () {
+      var _this3 = this;
+
+      if (this._internalModel) {
+        var draftContext = this._getDraftContext();
+
+        var activeContext;
+        draftContext.requestProperty("IsActiveEntity").then(function () {
+          return draftContext.getModel().bindContext("".concat(_this3._rootPath, "/SiblingEntity")).getBoundContext();
+        }).then(function (context) {
+          activeContext = context;
+          return context.requestCanonicalPath();
+        }).then(function () {
+          return draft.deleteDraft(draftContext);
+        }).then(function () {
+          activeContext.delete();
+          broadcastCollaborationMessage(Activity.Delete, _this3._rootPath, _this3._internalModel);
+
+          _this3._internalModel.destroy();
+
+          _this3._internalModel = undefined;
+        }).catch(function (err) {
+          Log.error(err);
+        });
+      }
+    },
+    // /////////////////////////////
+    // Private methods
+    _getDraftContext: function () {
+      return this._oModel.bindContext(this._rootPath, undefined, {
+        $$patchWithoutSideEffects: true,
+        $$groupId: "$auto",
+        $$updateGroupId: "$auto"
+      }).getBoundContext();
+    },
+
+    /**
+     * Callback of the ghost client when receiving a message on the web socket.
+     *
+     * @param oMessage The message
+     */
+    _onMessageReceived: function (oMessage) {
+      oMessage.userAction = oMessage.userAction || oMessage.clientAction;
+      this._lastReceivedMessage = oMessage;
+
+      if (oMessage.userAction === Activity.Join) {
+        broadcastCollaborationMessage(Activity.JoinEcho, this._lockedPropertyPath ? "".concat(this._rootPath, "/").concat(this._lockedPropertyPath) : undefined, this._internalModel);
+      }
+    }
+  };
+  return CollaborationAPI;
+}, false);
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIkNvbGxhYm9yYXRpb25BUEkudHMiXSwibmFtZXMiOlsiQ29sbGFib3JhdGlvbkFQSSIsIl9sYXN0UmVjZWl2ZWRNZXNzYWdlIiwidW5kZWZpbmVkIiwiX3Jvb3RQYXRoIiwiX29Nb2RlbCIsIl9sb2NrZWRQcm9wZXJ0eVBhdGgiLCJfaW50ZXJuYWxNb2RlbCIsImVudGVyRHJhZnQiLCJvQ29udGV4dCIsInVzZXJJRCIsInVzZXJOYW1lIiwid2ViU29ja2V0QmFzZVVSTCIsImdldE1vZGVsIiwiZ2V0TWV0YU1vZGVsIiwiZ2V0T2JqZWN0IiwiTG9nIiwiZXJyb3IiLCJzRHJhZnRVVUlEIiwiZ2V0UHJvcGVydHkiLCJKU09OTW9kZWwiLCJpbml0aWFsaXplQ29sbGFib3JhdGlvbiIsImlkIiwibmFtZSIsImluaXRpYWxOYW1lIiwiX29uTWVzc2FnZVJlY2VpdmVkIiwiYmluZCIsImdldFBhdGgiLCJjaGVja1JlY2VpdmVkIiwibWVzc2FnZSIsImZvdW5kIiwidXNlckFjdGlvbiIsImNsaWVudENvbnRlbnQiLCJsZWF2ZURyYWZ0IiwiZW5kQ29sbGFib3JhdGlvbiIsImRlc3Ryb3kiLCJzdGFydExpdmVDaGFuZ2UiLCJzUHJvcGVydHlQYXRoIiwidW5kb0NoYW5nZSIsImJyb2FkY2FzdENvbGxhYm9yYXRpb25NZXNzYWdlIiwiQWN0aXZpdHkiLCJMaXZlQ2hhbmdlIiwidXBkYXRlUHJvcGVydHlWYWx1ZSIsInZhbHVlIiwib0NvbnRleHRCaW5kaW5nIiwiYmluZENvbnRleHQiLCIkJHBhdGNoV2l0aG91dFNpZGVFZmZlY3RzIiwiJCRncm91cElkIiwiJCR1cGRhdGVHcm91cElkIiwib1Byb3BlcnR5QmluZGluZyIsImJpbmRQcm9wZXJ0eSIsImdldEJvdW5kQ29udGV4dCIsInJlcXVlc3RWYWx1ZSIsInRoZW4iLCJzZXRWYWx1ZSIsImF0dGFjaEV2ZW50T25jZSIsIkNoYW5nZSIsImNhdGNoIiwiZXJyIiwiVW5kbyIsImRpc2NhcmREcmFmdCIsImRyYWZ0Q29udGV4dCIsIl9nZXREcmFmdENvbnRleHQiLCJyZXF1ZXN0UHJvcGVydHkiLCJkcmFmdCIsImRlbGV0ZURyYWZ0IiwiRGlzY2FyZCIsInJlcGxhY2UiLCJhY3RpdmVDb250ZXh0IiwiY29udGV4dCIsInJlcXVlc3RDYW5vbmljYWxQYXRoIiwiZGVsZXRlIiwiRGVsZXRlIiwib01lc3NhZ2UiLCJjbGllbnRBY3Rpb24iLCJKb2luIiwiSm9pbkVjaG8iXSwibWFwcGluZ3MiOiI7QUFBQTtBQUNBO0FBQ0E7Ozs7Ozs7OztBQVdBLE1BQU1BLGdCQUFnQixHQUFHO0FBQ3hCQyxJQUFBQSxvQkFBb0IsRUFBRUMsU0FERTtBQUV4QkMsSUFBQUEsU0FBUyxFQUFFLEVBRmE7QUFHeEJDLElBQUFBLE9BQU8sRUFBRUYsU0FIZTtBQUl4QkcsSUFBQUEsbUJBQW1CLEVBQUUsRUFKRztBQUt4QkMsSUFBQUEsY0FBYyxFQUFFSixTQUxROztBQU94QjtBQUNEO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNDSyxJQUFBQSxVQUFVLEVBQUUsVUFBVUMsUUFBVixFQUE2QkMsTUFBN0IsRUFBNkNDLFFBQTdDLEVBQStEO0FBQzFFLFVBQU1DLGdCQUF3QixHQUFHSCxRQUFRLENBQUNJLFFBQVQsR0FBb0JDLFlBQXBCLEdBQW1DQyxTQUFuQyxDQUE2QyxtREFBN0MsQ0FBakM7O0FBRUEsVUFBSSxDQUFDSCxnQkFBTCxFQUF1QjtBQUN0QkksUUFBQUEsR0FBRyxDQUFDQyxLQUFKLENBQVUseUNBQVY7QUFDQTtBQUNBOztBQUVELFVBQU1DLFVBQWtCLEdBQUdULFFBQVEsQ0FBQ1UsV0FBVCxDQUFxQixtQ0FBckIsQ0FBM0I7QUFDQSxXQUFLWixjQUFMLEdBQXNCLElBQUlhLFNBQUosQ0FBYyxFQUFkLENBQXRCO0FBRUFDLE1BQUFBLHVCQUF1QixDQUN0QjtBQUNDQyxRQUFBQSxFQUFFLEVBQUVaLE1BREw7QUFFQ2EsUUFBQUEsSUFBSSxFQUFFWixRQUZQO0FBR0NhLFFBQUFBLFdBQVcsRUFBRWI7QUFIZCxPQURzQixFQU10QkMs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LE1BQUksQ0FBQzVCLGNBQUwsR0FBc0JKLFNBQXRCO0FBQ0EsU0FqQkYsRUFrQkVzRCxLQWxCRixDQWtCUSxVQUFVQyxHQUFWLEVBQW9CO0FBQzFCMUMsVUFBQUEsR0FBRyxDQUFDQyxLQUFKLENBQVV5QyxHQUFWO0FBQ0EsU0FwQkY7QUFxQkE7QUFDRCxLQWhNdUI7QUFrTXhCO0FBQ0E7QUFFQUksSUFBQUEsZ0JBQWdCLEVBQUUsWUFBaUI7QUFDbEMsYUFBTyxLQUFLekQsT0FBTCxDQUFjd0MsV0FBZCxDQUEwQixLQUFLekMsU0FBL0IsRUFBMENELFNBQTFDLEVBQXFEO0FBQzNEMkMsUUFBQUEseUJBQXlCLEVBQUUsSUFEZ0M7QUFFM0RDLFFBQUFBLFNBQVMsRUFBRSxPQUZnRDtBQUczREMsUUFBQUEsZUFBZSxFQUFFO0FBSDBDLE9BQXJELEVBSUpHLGVBSkksRUFBUDtBQUtBLEtBM011Qjs7QUE2TXhCO0FBQ0Q7QUFDQTtBQUNBO0FBQ0E7QUFDQzFCLElBQUFBLGtCQUFrQixFQUFFLFVBQVVnRCxRQUFWLEVBQTZCO0FBQ2hEQSxNQUFBQSxRQUFRLENBQUMxQyxVQUFULEdBQXNCMEMsUUFBUSxDQUFDMUMsVUFBVCxJQUF1QjBDLFFBQVEsQ0FBQ0MsWUFBdEQ7QUFDQSxXQUFLeEUsb0JBQUwsR0FBNEJ1RSxRQUE1Qjs7QUFFQSxVQUFJQSxRQUFRLENBQUMxQyxVQUFULEtBQXdCUyxRQUFRLENBQUNtQyxJQUFyQyxFQUEyQztBQUMxQ3BDLFFBQUFBLDZCQUE2QixDQUM1QkMsUUFBUSxDQUFDb0MsUUFEbUIsRUFFNUIsS0FBS3RFLG1CQUFMLGFBQThCLEtBQUtGLFNBQW5DLGNBQWdELEtBQUtFLG1CQUFyRCxJQUE2RUgsU0FGakQsRUFHNUIsS0FBS0ksY0FIdUIsQ0FBN0I7QUFLQTtBQUNEO0FBN051QixHQUF6QjtTQWdPZU4sZ0IiLCJzb3VyY2VSb290IjoiLiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBMb2cgZnJvbSBcInNhcC9iYXNlL0xvZ1wiO1xuaW1wb3J0IHtcblx0YnJvYWRjYXN0Q29sbGFib3JhdGlvbk1lc3NhZ2UsXG5cdGVuZENvbGxhYm9yYXRpb24sXG5cdGluaXRpYWxpemVDb2xsYWJvcmF0aW9uXG59IGZyb20gXCJzYXAvZmUvY29yZS9jb250cm9sbGVyZXh0ZW5zaW9ucy9jb2xsYWJvcmF0aW9uL0FjdGl2aXR5QmFzZVwiO1xuaW1wb3J0IHR5cGUgeyBNZXNzYWdlIH0gZnJvbSBcInNhcC9mZS9jb3JlL2NvbnRyb2xsZXJleHRlbnNpb25zL2NvbGxhYm9yYXRpb24vQ29sbGFib3JhdGlvbkNvbW1vblwiO1xuaW1wb3J0IHsgQWN0aXZpdHkgfSBmcm9tIFwic2FwL2ZlL2NvcmUvY29udHJvbGxlcmV4dGVuc2lvbnMvY29sbGFib3JhdGlvbi9Db2xsYWJvcmF0aW9uQ29tbW9uXCI7XG5pbXBvcnQgZHJhZnQgZnJvbSBcInNhcC9mZS9jb3JlL2NvbnRyb2xsZXJleHRlbnNpb25zL2VkaXRGbG93L2RyYWZ0XCI7XG5pbXBvcnQgdHlwZSBDb250ZXh0IGZyb20gXCJzYXAvdWkvbW9kZWwvQ29udGV4dFwiO1xuaW1wb3J0IEpTT05Nb2RlbCBmcm9tIFwic2FwL3VpL21vZGVsL2pzb24vSlNPTk1vZGVsXCI7XG5pbXBvcnQgdHlwZSBPRGF0YU1vZGVsIGZyb20gXCJzYXAvdWkvbW9kZWwvb2RhdGEvdjQvT0RhdGFNb2RlbFwiO1xuXG5jb25zdCBDb2xsYWJvcmF0aW9uQVBJID0ge1xuXHRfbGFzdFJlY2VpdmVkTWVzc2FnZTogdW5kZWZpbmVkIGFzIE1lc3NhZ2UgfCB1bmRlZmluZWQsXG5cdF9yb290UGF0aDogXCJcIixcblx0X29Nb2RlbDogdW5kZWZpbmVkIGFzIE9EYXRhTW9kZWwgfCB1bmRlZmluZWQsXG5cdF9sb2NrZWRQcm9wZXJ0eVBhdGg6IFwiXCIsXG5cdF9pbnRlcm5hbE1vZGVsOiB1bmRlZmluZWQgYXMgSlNPTk1vZGVsIHwgdW5kZWZpbmVkLFxuXG5cdC8qKlxuXHQgKiBPcGVuIGFuIGV4aXN0aW5nIGNvbGxhYm9yYXRpdmUgZHJhZnQgd2l0aCBhIG5ldyB1c2VyLCBhbmQgY3JlYXRlcyBhICdnaG9zdCBjbGllbnQnIGZvciB0aGlzIHVzZXIuXG5cdCAqXG5cdCAqIEBwYXJhbSBvQ29udGV4dCBUaGUgY29udGV4dCBvZiB0aGUgY29sbGFib3JhdGl2ZSBkcmFmdFxuXHQgKiBAcGFyYW0gdXNlcklEIFRoZSBJRCBvZiB0aGUgdXNlclxuXHQgKiBAcGFyYW0gdXNlck5hbWUgVGhlIG5hbWUgb2YgdGhlIHVzZXJcblx0ICovXG5cdGVudGVyRHJhZnQ6IGZ1bmN0aW9uIChvQ29udGV4dDogQ29udGV4dCwgdXNlcklEOiBzdHJpbmcsIHVzZXJOYW1lOiBzdHJpbmcpIHtcblx0XHRjb25zdCB3ZWJTb2NrZXRCYXNlVVJMOiBzdHJpbmcgPSBvQ29udGV4dC5nZXRNb2RlbCgpLmdldE1ldGFNb2RlbCgpLmdldE9iamVjdChcIi9AY29tLnNhcC52b2NhYnVsYXJpZXMuQ29tbW9uLnYxLldlYlNvY2tldEJhc2VVUkxcIik7XG5cblx0XHRpZiAoIXdlYlNvY2tldEJhc2VVUkwpIHtcblx0XHRcdExvZy5lcnJvcihcIkNhbm5vdCBmaW5kIFdlYlNvY2tldEJhc2VVUkwgYW5ub3RhdGlvblwiKTtcblx0XHRcdHJldHVybjtcblx0XHR9XG5cblx0XHRjb25zdCBzRHJhZnRVVUlEOiBzdHJpbmcgPSBvQ29udGV4dC5nZXRQcm9wZXJ0eShcIkRyYWZ0QWRtaW5pc3RyYXRpdmVEYXRhL0RyYWZ0VVVJRFwiKTtcblx0XHR0aGlzLl9pbnRlcm5hbE1vZGVsID0gbmV3IEpTT05Nb2RlbCh7fSk7XG5cblx0XHRpbml0aWFsaXplQ29sbGFib3JhdGlvbihcblx0XHRcdHtcblx0XHRcdFx0aWQ6IHVzZXJJRCxcblx0XHRcdFx0bmFtZTogdXNlck5hbWUsXG5cdFx0XHRcdGluaXRpYWxOYW1lOiB1c2VyTmFtZVxuXHRcdFx0fSxcblx0XHRcdHdlYlNvY2tldEJhc2VVUkwsXG5cdFx0XHRzRHJhZnRVVUlELFxuXHRcdFx0dGhpcy5faW50ZXJuYWxNb2RlbCxcblx0XHRcdHRoaXMuX29uTWVzc2FnZVJlY2VpdmVkLmJpbmQodGhpcyksXG5cdFx0XHR0cnVlXG5cdFx0KTtcblxuXHRcdHRoaXMuX3Jvb3RQYXRoID0gb0NvbnRleHQuZ2V0UGF0aCgpO1xuXHRcdHRoaXMuX29Nb2RlbCA9IG9Db250ZXh0LmdldE1vZGVsKCkgYXMgT0RhdGFNb2RlbDtcblx0fSxcblxuXHQvKipcblx0ICogQ2hlY2tzIGlmIHRoZSBnaG9zdCBjbGllbnQgaGFzIHJldmlldmVkIGEgZ2l2ZW4gbWVzc2FnZS5cblx0ICpcblx0ICogQHBhcmFtIG1lc3NhZ2UgVGhlIG1lc3NhZ2UgY29udGVudCB0byBiZSBsb29rZWQgZm9yXG5cdCAqIEByZXR1cm5zIFRydWUgaWYgdGhlIGxhc3QgcmVjaWV2ZWQgbWVzc2FnZSBtYXRjaGVzIHRoZSBjb250ZW50XG5cdCAqL1xuXHRjaGVja1JlY2VpdmVkOiBmdW5jdGlvbiAobWVzc2FnZTogUGFydGlhbDxNZXNzYWdlPik6IGJvb2xlYW4ge1xuXHRcdGlmICghdGhpcy5fbGFzdFJlY2VpdmVkTWVzc2FnZSkge1xuXHRcdFx0cmV0dXJuIGZhbHNlO1xuXHRcdH1cblxuXHRcdGNvbnN0IGZvdW5kID1cblx0XHRcdCghbWVzc2FnZS51c2VySUQgfHwgbWVzc2FnZS51c2VySUQgPT09IHRoaXMuX2xhc3RSZWNlaXZlZE1lc3NhZ2UudXNlcklEKSAmJlxuXHRcdFx0KCFtZXNzYWdlLnVzZXJBY3Rpb24gfHwgbWVzc2FnZS51c2VyQWN0aW9uID09PSB0aGlzLl9sYXN0UmVjZWl2ZWRNZXNzYWdlLnVzZXJBY3Rpb24pICYmXG5cdFx0XHQoIW1lc3NhZ2UuY2xpZW50Q29udGVudCB8fCBtZXNzYWdlLmNsaWVudENvbnRlbnQgPT09IHRoaXMuX2xhc3RSZWNlaXZlZE1lc3NhZ2UuY2xpZW50Q29udGVudCk7XG5cblx0XHR0aGlzLl9sYXN0UmVjZWl2ZWRNZXNzYWdlID0gdW5kZWZpbmVkOyAvLyByZXNldCBoaXN0b3J5IHRvIGF2b2lkIGZpbmRpbmcgdGhlIHNhbWUgbWVzc2FnZSB0d2ljZVxuXG5cdFx0cmV0dXJuIGZvdW5kO1xuXHR9LFxuXG5cdC8qKlxuXHQgKiBDbG9zZXMgdGhlIGdob3N0IGNsaWVudCBhbmQgcmVtb3ZlcyB0aGUgdXNlciBmcm9tIHRoZSBjb2xsYWJvcmF0aXZlIGRyYWZ0LlxuXHQgKi9cblx0bGVhdmVEcmFmdDogZnVuY3Rpb24gKCkge1xuXHRcdGlmICh0aGlzLl9pbnRlcm5hbE1vZGVsKSB7XG5cdFx0XHRlbmRDb2xsYWJvcmF0aW9uKHRoaXMuX2ludGVybmFsTW9kZWwpO1xuXHRcdFx0dGhpcy5faW50ZXJuYWxNb2RlbC5kZXN0cm95KCk7XG5cdFx0XHR0aGlzLl9pbnRlcm5hbE1vZGVsID0gdW5kZWZpbmVkO1xuXHRcdH1cblx0fSxcblxuXHQvKipcblx0ICogU2ltdWxhdGVzIHRoYXQgdGhlIHVzZXIgc3RhcnRzIHR5cGluZyBpbiBhbiBpbnB1dCAobGl2ZSBjaGFuZ2UpLlxuXHQgKlxuXHQgKiBAcGFyYW0gc1Byb3BlcnR5UGF0aCBUaGUgcGF0aCBvZiB0aGUgcHJvcGVydHkgYmVpbmcgbW9kaWZpZWRcblx0ICovXG5cdHN0YXJ0TGl2ZUNoYW5nZTogZnVuY3Rpb24gKHNQcm9wZXJ0eVBhdGg6IHN0cmluZykge1xuXHRcdGlmICh0aGlzLl9pbnRlcm5hbE1vZGVsKSB7XG5cdFx0XHRpZiAodGhpcy5fbG9ja2VkUHJvcGVydHlQYXRoKSB7XG5cdFx0XHRcdC8vIFVubG9jayBwcmV2aW91cyBwcm9wZXJ0eSBwYXRoXG5cdFx0XHRcdHRoaXMudW5kb0NoYW5nZSgpO1xuXHRcdFx0fVxuXHRcdFx0dGhpcy5fbG9ja2VkUHJvcGVydHlQYXRoID0gc1Byb3BlcnR5UGF0aDtcblx0XHRcdGJyb2FkY2FzdENvbGxhYm9yYXRpb25NZXNzYWdlKEFjdGl2aXR5LkxpdmVDaGFuZ2UsIGAke3RoaXMuX3Jvb3RQYXRofS8ke3NQcm9wZXJ0eVBhdGh9YCwgdGhpcy5faW50ZXJuYWxNb2RlbCk7XG5cdFx0fVxuXHR9LFxuXG5cdC8qKlxuXHQgKiBTaW11bGF0ZXMgdGhhdCB0aGUgdXNlciBoYXMgbW9kaWZpZWQgYSBwcm9wZXJ0eS5cblx0ICpcblx0ICogQHBhcmFtIHNQcm9wZXJ0eVBhdGggVGhlIHBhdGggb2YgdGhlIHByb3BlcnR5IGJlaW5nIG1vZGlmaWVkXG5cdCAqIEBwYXJhbSB2YWx1ZSBUaGUgbmV3IHZhbHVlIG9mIHRoZSBwcm9wZXJ0eSBiZWluZyBtb2RpZmllZFxuXHQgKi9cblx0dXBkYXRlUHJvcGVydHlWYWx1ZTogZnVuY3Rpb24gKHNQcm9wZXJ0eVBhdGg6IHN0cmluZywgdmFsdWU6IGFueSkge1xuXHRcdGlmICh0aGlzLl9pbnRlcm5hbE1vZGVsKSB7XG5cdFx0XHRpZiAodGhpcy5fbG9ja2VkUHJvcGVydHlQYXRoICE9PSBzUHJvcGVydHlQYXRoKSB7XG5cdFx0XHRcdHRoaXMuc3RhcnRMaXZlQ2hhbmdlKHNQcm9wZXJ0eVBhdGgpO1xuXHRcdFx0fVxuXG5cdFx0XHRjb25zdCBvQ29udGV4dEJpbmRpbmcgPSB0aGlzLl9vTW9kZWwhLmJpbmRDb250ZXh0KHRoaXMuX3Jvb3RQYXRoLCB1bmRlZmluZWQsIHtcblx0XHRcdFx0JCRwYXRjaFdpdGhvdXRTaWRlRWZmZWN0czogdHJ1ZSxcblx0XHRcdFx0JCRncm91cElkOiBcIiRhdXRvXCIsXG5cdFx0XHRcdCQkdXBkYXRlR3JvdXBJZDogXCIkYXV0b1wiXG5cdFx0XHR9KTtcblxuXHRcdFx0Y29uc3Qgb1Byb3BlcnR5QmluZGluZyA9IHRoaXMuX29Nb2RlbCEuYmluZFByb3BlcnR5KHNQcm9wZXJ0eVBhdGgsIG9Db250ZXh0QmluZGluZy5nZXRCb3VuZENvbnRleHQoKSk7XG5cblx0XHRcdG9Qcm9wZXJ0eUJpbmRpbmdcblx0XHRcdFx0LnJlcXVlc3RWYWx1ZSgpXG5cdFx0XHRcdC50aGVuKCgpID0+IHtcblx0XHRcdFx0XHRvUHJvcGVydHlCaW5kaW5nLnNldFZhbHVlKHZhbHVlKTtcblx0XHRcdFx0XHRvQ29udGV4dEJpbmRpbmcuYXR0YWNoRXZlbnRPbmNlKFwicGF0Y2hDb21wbGV0ZWRcIiwgKCkgPT4ge1xuXHRcdFx0XHRcdFx0YnJvYWRjYXN0Q29sbGFib3JhdGlvbk1lc3NhZ2UoQWN0aXZpdHkuQ2hhbmdlLCBgJHt0aGlzLl9yb290UGF0aH0vJHtzUHJvcGVydHlQYXRofWAsIHRoaXMuX2ludGVybmFsTW9kZWwhKTtcblx0XHRcdFx0XHRcdHRoaXMuX2xvY2tlZFByb3BlcnR5UGF0aCA9IFwiXCI7XG5cdFx0XHRcdFx0fSk7XG5cdFx0XHRcdH0pXG5cdFx0XHRcdC5jYXRjaChmdW5jdGlvbiAoZXJyKSB7XG5cdFx0XHRcdFx0TG9nLmVycm9yKGVycik7XG5cdFx0XHRcdH0pO1xuXHRcdH1cblx0fSxcblxuXHQvKipcblx0ICogU2ltdWxhdGVzIHRoYXQgdGhlIHVzZXIgZGlkIGFuICd1bmRvJyAodG8gYmUgY2FsbGVkIGFmdGVyIHN0YXJ0TGl2ZUNoYW5nZSkuXG5cdCAqL1xuXHR1bmRvQ2hhbmdlOiBmdW5jdGlvbiAoKSB7XG5cdFx0aWYgKHRoaXMuX2xvY2tlZFByb3BlcnR5UGF0aCkge1xuXHRcdFx0YnJvYWRjYXN0Q29sbGFib3JhdGlvbk1lc3NhZ2UoQWN0aXZpdHkuVW5kbywgYCR7dGhpcy5fcm9vdFBhdGh9LyR7dGhpcy5fbG9ja2VkUHJvcGVydHlQYXRofWAsIHRoaXMuX2ludGVybmFsTW9kZWwhKTtcblx0XHRcdHRoaXMuX2xvY2tlZFByb3BlcnR5UGF0aCA9IFwiXCI7XG5cdFx0fVxuXHR9LFxuXG5cdC8qKlxuXHQgKiBTaW11bGF0ZXMgdGhhdCB0aGUgdXNlciBoYXMgZGlzY2FyZGVkIHRoZSBkcmFmdC5cblx0ICovXG5cdGRpc2NhcmREcmFmdDogZnVuY3Rpb24gKCkge1xuXHRcdGlmICh0aGlzLl9pbnRlcm5hbE1vZGVsKSB7XG5cdFx0XHRjb25zdCBkcmFmdENvbnRleHQgPSB0aGlzLl9nZXREcmFmdENvbnRleHQoKTtcblxuXHRcdFx0ZHJhZnRDb250ZXh0XG5cdFx0XHRcdC5yZXF1ZXN0UHJvcGVydHkoXCJJc0FjdGl2ZUVudGl0eVwiKVxuXHRcdFx0XHQudGhlbigoKSA9PiB7XG5cdFx0XHRcdFx0ZHJhZnQuZGVsZXRlRHJhZnQoZHJhZnRDb250ZXh0KTtcblx0XHRcdFx0fSlcblx0XHRcdFx0LnRoZW4oKCkgPT4ge1xuXHRcdFx0XHRcdGJyb2FkY2FzdENvbGxhYm9yYXRpb25NZXNzYWdlKFxuXHRcdFx0XHRcdFx0QWN0aXZpdHkuRGlzY2FyZCxcblx0XHRcdFx0XHRcdHRoaXMuX3Jvb3RQYXRoLnJlcGxhY2UoXCJJc0FjdGl2ZUVudGl0eT1mYWxzZVwiLCBcIklzQWN0aXZlRW50aXR5PXRydWVcIiksXG5cdFx0XHRcdFx0XHR0aGlzLl9pbnRlcm5hbE1vZGVsIVxuXHRcdFx0XHRcdCk7XG5cdFx0XHRcdFx0dGhpcy5faW50ZXJuYWxNb2RlbCEuZGVzdHJveSgpO1xuXHRcdFx0XHRcdHRoaXMuX2ludGVybmFsTW9kZWwgPSB1bmRlZmluZWQ7XG5cdFx0XHRcdH0pXG5cdFx0XHRcdC5jYXRjaChmdW5jdGlvbiAoZXJyOiBhbnkpIHtcblx0XHRcdFx0XHRMb2cuZXJyb3IoZXJyKTtcblx0XHRcdFx0fSk7XG5cdFx0fVxuXHR9LFxuXG5cdC8qKlxuXHQgKiBTaW11bGF0ZXMgdGhhdCB0aGUgdXNlciBoYXMgZGVsZXRlZCB0aGUgZHJhZnQuXG5cdCAqL1xuXHRkZWxldGVEcmFmdDogZnVuY3Rpb24gKCkge1xuXHRcdGlmICh0aGlzLl9pbnRlcm5hbE1vZGVsKSB7XG5cdFx0XHRjb25zdCBkcmFmdENvbnRleHQgPSB0aGlzLl9nZXREcmFmdENvbnRleHQoKTtcblx0XHRcdGxldCBhY3RpdmVDb250ZXh0OiBDb250ZXh0O1xuXG5cdFx0XHRkcmFmdENvbnRleHRcblx0XHRcdFx0LnJlcXVlc3RQcm9wZXJ0eShcIklzQWN0aXZlRW50aXR5XCIpXG5cdFx0XHRcdC50aGVuKCgpID0+IHtcblx0XHRcdFx0XHRyZXR1cm4gZHJhZnRDb250ZXh0LmdldE1vZGVsKCkuYmluZENvbnRleHQoYCR7dGhpcy5fcm9vdFBhdGh9L1NpYmxpbmdFbnRpdHlgKS5nZXRCb3VuZENvbnRleHQoKTtcblx0XHRcdFx0fSlcblx0XHRcdFx0LnRoZW4oKGNvbnRleHQ6IGFueSkgPT4ge1xuXHRcdFx0XHRcdGFjdGl2ZUNvbnRleHQgPSBjb250ZXh0O1xuXHRcdFx0XHRcdHJldHVybiBjb250ZXh0LnJlcXVlc3RDYW5vbmljYWxQYXRoKCk7XG5cdFx0XHRcdH0pXG5cdFx0XHRcdC50aGVuKCgpID0+IHtcblx0XHRcdFx0XHRyZXR1cm4gZHJhZnQuZGVsZXRlRHJhZnQoZHJhZnRDb250ZXh0KTtcblx0XHRcdFx0fSlcblx0XHRcdFx0LnRoZW4oKCkgPT4ge1xuXHRcdFx0XHRcdChhY3RpdmVDb250ZXh0IGFzIGFueSkuZGVsZXRlKCk7XG5cdFx0XHRcdFx0YnJvYWRjYXN0Q29sbGFib3JhdGlvbk1lc3NhZ2UoQWN0aXZpdHkuRGVsZXRlLCB0aGlzLl9yb290UGF0aCwgdGhpcy5faW50ZXJuYWxNb2RlbCEpO1xuXHRcdFx0XHRcdHRoaXMuX2ludGVybmFsTW9kZWwhLmRlc3Ryb3koKTtcblx0XHRcdFx0XHR0aGlzLl9pbnRlcm5hbE1vZGVsID0gdW5kZWZpbmVkO1xuXHRcdFx0XHR9KVxuXHRcdFx0XHQuY2F0Y2goZnVuY3Rpb24gKGVycjogYW55KSB7XG5cdFx0XHRcdFx0TG9nLmVycm9yKGVycik7XG5cdFx0XHRcdH0pO1xuXHRcdH1cblx0fSxcblxuXHQvLyAvLy8vLy8vLy8vLy8vLy8vLy8vLy8vLy8vLy8vL1xuXHQvLyBQcml2YXRlIG1ldGhvZHNcblxuXHRfZ2V0RHJhZnRDb250ZXh0OiBmdW5jdGlvbiAoKTogYW55IHtcblx0XHRyZXR1cm4gdGhpcy5fb01vZGVsIS5iaW5kQ29udGV4dCh0aGlzLl9yb290UGF0aCwgdW5kZWZpbmVkLCB7XG5cdFx0XHQkJHBhdGNoV2l0aG91dFNpZGVFZmZlY3RzOiB0cnVlLFxuXHRcdFx0JCRncm91cElkOiBcIiRhdXRvXCIsXG5cdFx0XHQkJHVwZGF0ZUdyb3VwSWQ6IFwiJGF1dG9cIlxuXHRcdH0pLmdldEJvdW5kQ29udGV4dCgpO1xuXHR9LFxuXG5cdC8qKlxuXHQgKiBDYWxsYmFjayBvZiB0aGUgZ2hvc3QgY2xpZW50IHdoZW4gcmVjZWl2aW5nIGEgbWVzc2FnZSBvbiB0aGUgd2ViIHNvY2tldC5cblx0ICpcblx0ICogQHBhcmFtIG9NZXNzYWdlIFRoZSBtZXNzYWdlXG5cdCAqL1xuXHRfb25NZXNzYWdlUmVjZWl2ZWQ6IGZ1bmN0aW9uIChvTWVzc2FnZTogTWVzc2FnZSkge1xuXHRcdG9NZXNzYWdlLnVzZXJBY3Rpb24gPSBvTWVzc2FnZS51c2VyQWN0aW9uIHx8IG9NZXNzYWdlLmNsaWVudEFjdGlvbjtcblx0XHR0aGlzLl9sYXN0UmVjZWl2ZWRNZXNzYWdlID0gb01lc3NhZ2U7XG5cblx0XHRpZiAob01lc3NhZ2UudXNlckFjdGlvbiA9PT0gQWN0aXZpdHkuSm9pbikge1xuXHRcdFx0YnJvYWRjYXN0Q29sbGFib3JhdGlvbk1lc3NhZ2UoXG5cdFx0XHRcdEFjdGl2aXR5LkpvaW5FY2hvLFxuXHRcdFx0XHR0aGlzLl9sb2NrZWRQcm9wZXJ0eVBhdGggPyBgJHt0aGlzLl9yb290UGF0aH0vJHt0aGlzLl9sb2NrZWRQcm9wZXJ0eVBhdGh9YCA6IHVuZGVmaW5lZCxcblx0XHRcdFx0dGhpcy5faW50ZXJuYWxNb2RlbCFcblx0XHRcdCk7XG5cdFx0fVxuXHR9XG59O1xuXG5leHBvcnQgZGVmYXVsdCBDb2xsYWJvcmF0aW9uQVBJO1xuIl19

package/src/sap/fe/test/api/CollaborationAPI.ts

@@ -0,0 +1,238 @@
+import Log from "sap/base/Log";
+import {
+	broadcastCollaborationMessage,
+	endCollaboration,
+	initializeCollaboration
+} from "sap/fe/core/controllerextensions/collaboration/ActivityBase";
+import type { Message } from "sap/fe/core/controllerextensions/collaboration/CollaborationCommon";
+import { Activity } from "sap/fe/core/controllerextensions/collaboration/CollaborationCommon";
+import draft from "sap/fe/core/controllerextensions/editFlow/draft";
+import type Context from "sap/ui/model/Context";
+import JSONModel from "sap/ui/model/json/JSONModel";
+import type ODataModel from "sap/ui/model/odata/v4/ODataModel";
+
+const CollaborationAPI = {
+	_lastReceivedMessage: undefined as Message | undefined,
+	_rootPath: "",
+	_oModel: undefined as ODataModel | undefined,
+	_lockedPropertyPath: "",
+	_internalModel: undefined as JSONModel | undefined,
+
+	/**
+	 * Open an existing collaborative draft with a new user, and creates a 'ghost client' for this user.
+	 *
+	 * @param oContext The context of the collaborative draft
+	 * @param userID The ID of the user
+	 * @param userName The name of the user
+	 */
+	enterDraft: function (oContext: Context, userID: string, userName: string) {
+		const webSocketBaseURL: string = oContext.getModel().getMetaModel().getObject("/@com.sap.vocabularies.Common.v1.WebSocketBaseURL");
+
+		if (!webSocketBaseURL) {
+			Log.error("Cannot find WebSocketBaseURL annotation");
+			return;
+		}
+
+		const sDraftUUID: string = oContext.getProperty("DraftAdministrativeData/DraftUUID");
+		this._internalModel = new JSONModel({});
+
+		initializeCollaboration(
+			{
+				id: userID,
+				name: userName,
+				initialName: userName
+			},
+			webSocketBaseURL,
+			sDraftUUID,
+			this._internalModel,
+			this._onMessageReceived.bind(this),
+			true
+		);
+
+		this._rootPath = oContext.getPath();
+		this._oModel = oContext.getModel() as ODataModel;
+	},
+
+	/**
+	 * Checks if the ghost client has revieved a given message.
+	 *
+	 * @param message The message content to be looked for
+	 * @returns True if the last recieved message matches the content
+	 */
+	checkReceived: function (message: Partial<Message>): boolean {
+		if (!this._lastReceivedMessage) {
+			return false;
+		}
+
+		const found =
+			(!message.userID || message.userID === this._lastReceivedMessage.userID) &&
+			(!message.userAction || message.userAction === this._lastReceivedMessage.userAction) &&
+			(!message.clientContent || message.clientContent === this._lastReceivedMessage.clientContent);
+
+		this._lastReceivedMessage = undefined; // reset history to avoid finding the same message twice
+
+		return found;
+	},
+
+	/**
+	 * Closes the ghost client and removes the user from the collaborative draft.
+	 */
+	leaveDraft: function () {
+		if (this._internalModel) {
+			endCollaboration(this._internalModel);
+			this._internalModel.destroy();
+			this._internalModel = undefined;
+		}
+	},
+
+	/**
+	 * Simulates that the user starts typing in an input (live change).
+	 *
+	 * @param sPropertyPath The path of the property being modified
+	 */
+	startLiveChange: function (sPropertyPath: string) {
+		if (this._internalModel) {
+			if (this._lockedPropertyPath) {
+				// Unlock previous property path
+				this.undoChange();
+			}
+			this._lockedPropertyPath = sPropertyPath;
+			broadcastCollaborationMessage(Activity.LiveChange, `${this._rootPath}/${sPropertyPath}`, this._internalModel);
+		}
+	},
+
+	/**
+	 * Simulates that the user has modified a property.
+	 *
+	 * @param sPropertyPath The path of the property being modified
+	 * @param value The new value of the property being modified
+	 */
+	updatePropertyValue: function (sPropertyPath: string, value: any) {
+		if (this._internalModel) {
+			if (this._lockedPropertyPath !== sPropertyPath) {
+				this.startLiveChange(sPropertyPath);
+			}
+
+			const oContextBinding = this._oModel!.bindContext(this._rootPath, undefined, {
+				$$patchWithoutSideEffects: true,
+				$$groupId: "$auto",
+				$$updateGroupId: "$auto"
+			});
+
+			const oPropertyBinding = this._oModel!.bindProperty(sPropertyPath, oContextBinding.getBoundContext());
+
+			oPropertyBinding
+				.requestValue()
+				.then(() => {
+					oPropertyBinding.setValue(value);
+					oContextBinding.attachEventOnce("patchCompleted", () => {
+						broadcastCollaborationMessage(Activity.Change, `${this._rootPath}/${sPropertyPath}`, this._internalModel!);
+						this._lockedPropertyPath = "";
+					});
+				})
+				.catch(function (err) {
+					Log.error(err);
+				});
+		}
+	},
+
+	/**
+	 * Simulates that the user did an 'undo' (to be called after startLiveChange).
+	 */
+	undoChange: function () {
+		if (this._lockedPropertyPath) {
+			broadcastCollaborationMessage(Activity.Undo, `${this._rootPath}/${this._lockedPropertyPath}`, this._internalModel!);
+			this._lockedPropertyPath = "";
+		}
+	},
+
+	/**
+	 * Simulates that the user has discarded the draft.
+	 */
+	discardDraft: function () {
+		if (this._internalModel) {
+			const draftContext = this._getDraftContext();
+
+			draftContext
+				.requestProperty("IsActiveEntity")
+				.then(() => {
+					draft.deleteDraft(draftContext);
+				})
+				.then(() => {
+					broadcastCollaborationMessage(
+						Activity.Discard,
+						this._rootPath.replace("IsActiveEntity=false", "IsActiveEntity=true"),
+						this._internalModel!
+					);
+					this._internalModel!.destroy();
+					this._internalModel = undefined;
+				})
+				.catch(function (err: any) {
+					Log.error(err);
+				});
+		}
+	},
+
+	/**
+	 * Simulates that the user has deleted the draft.
+	 */
+	deleteDraft: function () {
+		if (this._internalModel) {
+			const draftContext = this._getDraftContext();
+			let activeContext: Context;
+
+			draftContext
+				.requestProperty("IsActiveEntity")
+				.then(() => {
+					return draftContext.getModel().bindContext(`${this._rootPath}/SiblingEntity`).getBoundContext();
+				})
+				.then((context: any) => {
+					activeContext = context;
+					return context.requestCanonicalPath();
+				})
+				.then(() => {
+					return draft.deleteDraft(draftContext);
+				})
+				.then(() => {
+					(activeContext as any).delete();
+					broadcastCollaborationMessage(Activity.Delete, this._rootPath, this._internalModel!);
+					this._internalModel!.destroy();
+					this._internalModel = undefined;
+				})
+				.catch(function (err: any) {
+					Log.error(err);
+				});
+		}
+	},
+
+	// /////////////////////////////
+	// Private methods
+
+	_getDraftContext: function (): any {
+		return this._oModel!.bindContext(this._rootPath, undefined, {
+			$$patchWithoutSideEffects: true,
+			$$groupId: "$auto",
+			$$updateGroupId: "$auto"
+		}).getBoundContext();
+	},
+
+	/**
+	 * Callback of the ghost client when receiving a message on the web socket.
+	 *
+	 * @param oMessage The message
+	 */
+	_onMessageReceived: function (oMessage: Message) {
+		oMessage.userAction = oMessage.userAction || oMessage.clientAction;
+		this._lastReceivedMessage = oMessage;
+
+		if (oMessage.userAction === Activity.Join) {
+			broadcastCollaborationMessage(
+				Activity.JoinEcho,
+				this._lockedPropertyPath ? `${this._rootPath}/${this._lockedPropertyPath}` : undefined,
+				this._internalModel!
+			);
+		}
+	}
+};
+
+export default CollaborationAPI;

package/src/sap/fe/test/api/DialogAPI.js

@@ -11,7 +11,7 @@ sap.ui.define(
 		"sap/fe/test/builder/MdcFieldBuilder",
 		"sap/fe/test/builder/DialogBuilder"
 	],
-	function(BaseAPI, Utils, FEBuilder, MdcFieldBuilder, DialogBuilder) {
+	function (BaseAPI, Utils, FEBuilder, MdcFieldBuilder, DialogBuilder) {
 		"use strict";
 
 		/**
@@ -19,12 +19,12 @@ sap.ui.define(
 		 *
 		 * @param {sap.fe.test.builder.DialogBuilder} oDialogBuilder The {@link sap.fe.test.builder.DialogBuilder} instance used to interact with the UI
 		 * @param {string} [vDialogDescription] Description (optional) of the dialog to be used for logging messages
-		 * @param {int} [iConfirmButtonIndex] Index of the 'confirm' button in the button aggregation; the default setting is 0 (first button from the left)
+		 * @param {number} [iConfirmButtonIndex] Index of the 'confirm' button in the button aggregation; the default setting is 0 (first button from the left)
 		 * @returns {sap.fe.test.api.DialogAPI} The new instance
 		 * @class
 		 * @private
 		 */
-		var DialogAPI = function(oDialogBuilder, vDialogDescription, iConfirmButtonIndex) {
+		var DialogAPI = function (oDialogBuilder, vDialogDescription, iConfirmButtonIndex) {
 			if (!Utils.isOfType(oDialogBuilder, DialogBuilder)) {
 				throw new Error("oDialogBuilder parameter must be a DialogBuilder instance");
 			}
@@ -40,12 +40,10 @@ sap.ui.define(
 		 *
 		 * @param {sap.fe.test.api.FieldIdentifier | string} vFieldIdentifier Identifier to be used for the matcher
 		 * @param {object} oDialogIdentifier Identifier for the dialog (create/action)
-		 *
 		 * @returns {object} A matcher
-		 *
 		 * @private
 		 */
-		DialogAPI.prototype._createFieldMatcher = function(vFieldIdentifier, oDialogIdentifier) {
+		DialogAPI.prototype._createFieldMatcher = function (vFieldIdentifier, oDialogIdentifier) {
 			var vMatcher, sFieldId;
 			if (!Utils.isOfType(vFieldIdentifier, String)) {
 				if (typeof vFieldIdentifier.property === "string") {
@@ -67,7 +65,7 @@ sap.ui.define(
 			return vMatcher;
 		};
 
-		DialogAPI.prototype._createFieldBuilder = function(vFieldIdentifier, oDialogIdentifier) {
+		DialogAPI.prototype._createFieldBuilder = function (vFieldIdentifier, oDialogIdentifier) {
 			var oMdcFieldBuilder = new MdcFieldBuilder(this.getOpaInstance());
 			return oMdcFieldBuilder
 				.isDialogElement()
@@ -75,18 +73,18 @@ sap.ui.define(
 				.has(this._createFieldMatcher(vFieldIdentifier, oDialogIdentifier));
 		};
 
-		DialogAPI.prototype._getConfirmButtonMatcher = function() {
+		DialogAPI.prototype._getConfirmButtonMatcher = function () {
 			var iConfirmButtonIndex = this._iConfirmButtonIndex;
-			return function(oButton) {
+			return function (oButton) {
 				var aButtons = oButton.getParent().getButtons();
 				// Confirm is (usually) the first button
 				return aButtons.indexOf(oButton) === Math.min(aButtons.length - 1, iConfirmButtonIndex);
 			};
 		};
 
-		DialogAPI.prototype._getCancelButtonMatcher = function() {
+		DialogAPI.prototype._getCancelButtonMatcher = function () {
 			var iConfirmButtonIndex = this._iConfirmButtonIndex;
-			return function(oButton) {
+			return function (oButton) {
 				var aButtons = oButton.getParent().getButtons();
 				// Cancel is (usually) right next to the first (confirm) button and (usually) the last one in the list
 				return aButtons.length > 2
@@ -95,9 +93,9 @@ sap.ui.define(
 			};
 		};
 
-		DialogAPI.prototype._getConfirmDiscardDraftButtonMatcher = function() {
+		DialogAPI.prototype._getConfirmDiscardDraftButtonMatcher = function () {
 			var iConfirmDiscardDraftButtonIndex = this._iConfirmDiscardDraftButtonIndex;
-			return function(oButton) {
+			return function (oButton) {
 				var aButtons = oButton.getParent().getButtons();
 				// for the KeepDraft/DiscardDraft message, the DiscardDraft button is the second in the list
 				return aButtons.indexOf(oButton) === iConfirmDiscardDraftButtonIndex;

package/src/sap/fe/test/api/DialogActions.js

@@ -3,7 +3,7 @@
         (c) Copyright 2009-2021 SAP SE. All rights reserved
     
  */
-sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], function(DialogAPI, Utils, OpaBuilder) {
+sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], function (DialogAPI, Utils, OpaBuilder) {
 	"use strict";
 
 	/**
@@ -11,14 +11,14 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 *
 	 * @param {sap.fe.test.builder.DialogBuilder} oDialogBuilder The {@link sap.fe.test.builder.DialogBuilder} instance used to interact with the UI
 	 * @param {string} [vDialogDescription] Description (optional) of the dialog to be used for logging messages
-	 * @param {int} [iConfirmButtonIndex] Index of the 'confirm' button in the button aggregation; the default setting is 0 (first button from the left)
+	 * @param {number} [iConfirmButtonIndex] Index of the 'confirm' button in the button aggregation; the default setting is 0 (first button from the left)
 	 * @returns {sap.fe.test.api.DialogActions} The new DialogActions instance
 	 * @alias sap.fe.test.api.DialogActions
 	 * @class
 	 * @hideconstructor
 	 * @public
 	 */
-	var DialogActions = function(oDialogBuilder, vDialogDescription, iConfirmButtonIndex) {
+	var DialogActions = function (oDialogBuilder, vDialogDescription, iConfirmButtonIndex) {
 		return DialogAPI.call(this, oDialogBuilder, vDialogDescription, iConfirmButtonIndex);
 	};
 	DialogActions.prototype = Object.create(DialogAPI.prototype);
@@ -31,7 +31,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogActions.prototype.iConfirm = function() {
+	DialogActions.prototype.iConfirm = function () {
 		return this.prepareResult(
 			this.getBuilder()
 				.doPressFooterButton(this._getConfirmButtonMatcher())
@@ -46,7 +46,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogActions.prototype.iCancel = function() {
+	DialogActions.prototype.iCancel = function () {
 		return this.prepareResult(
 			this.getBuilder()
 				.doPressFooterButton(this._getCancelButtonMatcher())
@@ -61,7 +61,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogActions.prototype.iClose = function() {
+	DialogActions.prototype.iClose = function () {
 		return this.prepareResult(
 			this.getBuilder()
 				.doPressKeyboardShortcut("Escape")
@@ -79,7 +79,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
 	 * @public
 	 */
-	DialogActions.prototype.iChangeDialogField = function(vFieldIdentifier, vValue, bClearFirst) {
+	DialogActions.prototype.iChangeDialogField = function (vFieldIdentifier, vValue, bClearFirst) {
 		var aArguments = Utils.parseArguments([Object, String, Boolean], arguments);
 		return this.prepareResult(
 			this._createFieldBuilder(vFieldIdentifier, this.getIdentifier())
@@ -108,7 +108,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
 	 * @ui5-restricted
 	 */
-	DialogActions.prototype.iChangeActionParameterDialogField = function(vFieldIdentifier, vValue, bClearFirst) {
+	DialogActions.prototype.iChangeActionParameterDialogField = function (vFieldIdentifier, vValue, bClearFirst) {
 		return this.iChangeDialogField(vFieldIdentifier, vValue, bClearFirst);
 	};