@open-xchange/appsuite-codeceptjs 0.1.0

package/src/pageobjects/calendar.js

@@ -0,0 +1,226 @@
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+const { I, contactpicker, autocomplete, dialogs } = inject()
+const moment = require('moment')
+
+module.exports = {
+
+  editWindow: '.io-ox-calendar-edit-window',
+  miniCalendar: '.window-sidepanel .date-picker',
+  title: '[data-extension-point="io.ox/calendar/edit/section"] input[name="summary"]',
+
+  async newAppointment () {
+    I.wait(1)
+    I.clickPrimary('New appointment')
+    I.waitForVisible(this.editWindow)
+    await I.waitForFocus('.io-ox-calendar-edit-window input[type="text"][name="summary"]')
+  },
+
+  clickAppointment (title, position = 1) {
+    I.wait(0.5) // wait for rendering
+    const appointment = locate('.page.current .appointment .title').withText(title).at(position).as('Appointment')
+    I.waitForElement(appointment)
+    I.scrollTo(appointment)
+    I.click(appointment)
+  },
+
+  getNextMonday () {
+    // isoWeekday is Monday=1 ... Sunday=7
+    // 8 means next Monday; also over the weekend before
+    return moment().isoWeekday(8).set('hour', 8)
+  },
+
+  startNextMonday () {
+    // use next monday to avoid problems when tests run over the weekend
+    const date = this.getNextMonday()
+    I.fillField('Starts on', date.format('L'))
+    I.clearField('~Start time')
+    I.fillField('~Start time', '8:00')
+    return date
+  },
+
+  moveCalendarViewToNextWeek () {
+    I.waitForText('Today', undefined, '.calendar-header')
+    I.click('Today')
+    I.waitForElement('~Next week')
+    I.click('~Next week')
+    // look for proper aria-label
+    I.waitForElement('~' + this.getNextMonday().format('ddd D') + ', create all-day appointment')
+  },
+
+  openScheduling () {
+    I.waitForElement(locate('button').withText('New appointment').as('New appointment'))
+    I.click('.primary-action button[aria-label="More actions"]')
+    I.waitForElement('.primary-action .dropdown-menu')
+    I.click('Scheduling', '.primary-action .dropdown-menu')
+  },
+
+  recurAppointment (date) {
+    I.checkOption('Repeat')
+    if (date) I.see(`Every ${date.format('dddd')}.`)
+    I.click('.recurrence-view button.summary')
+    I.waitForElement('.recurrence-view-dialog')
+  },
+
+  deleteAppointment () {
+    I.waitForElement('~Delete')
+    I.click('~Delete', '.detail-popup')
+    dialogs.waitForVisible()
+    dialogs.clickButton('Delete')
+    I.waitForDetached('.modal-dialog')
+  },
+
+  // attr: [startDate, endDate, until]
+  setDate (attr, value) {
+    I.click('~Date (M/D/YYYY)', locate(`[data-attribute="${attr}"]`).as('Date input'))
+    I.waitForElement('.date-picker.open')
+    I.click(`.dateinput[data-attribute="${attr}"] .datepicker-day-field`)
+    I.fillField(`.dateinput[data-attribute="${attr}"] .datepicker-day-field`, value.format('L'))
+    I.pressKey('Enter')
+    I.waitForDetached('.date-picker.open')
+  },
+
+  getDate (attr) {
+    return I.executeScript(function (attr) {
+      // fillfield works only for puppeteer, pressKey(11/10....) only for webdriver
+      // @ts-ignore
+      return document.querySelector(`.dateinput[data-attribute="${attr}"] .datepicker-day-field`).value
+    }, attr)
+  },
+
+  async addParticipant (name, exists, context, addedParticipants) {
+    if (!context) context = '*'
+    if (!addedParticipants) addedParticipants = 1
+
+    // does suggestion exists (for contact, user, ...)
+    exists = typeof exists === 'boolean' ? exists : true
+    const number = await I.grabNumberOfVisibleElements(locate('.attendee').inside(context).as('Attendee')) + addedParticipants
+    const addParticipantsLocator = locate('.add-participant.tt-input').inside(context).as('Add participant field')
+    // input field
+    I.waitForVisible(addParticipantsLocator)
+    I.waitForEnabled(addParticipantsLocator)
+    I.fillField(addParticipantsLocator, name)
+    I.seeInField(addParticipantsLocator, name)
+    // tokenfield/typeahead
+    if (exists) {
+      autocomplete.select(name, context.replace('.', ''))
+    } else {
+      I.pressKey('Enter')
+    }
+
+    I.waitForInvisible(autocomplete.suggestions)
+    // note: might be more than one that get's added (group)
+    I.waitForElement(locate('.attendee').inside(context).at(number).as(`Attendee ${number}`))
+  },
+
+  async addParticipantByPicker (name) {
+    I.click('~Select contacts')
+    await contactpicker.add(name)
+    contactpicker.close()
+    I.waitForText(name, undefined, '.attendee-container')
+  },
+
+  switchView (view) {
+    I.waitForElement('.page.current .calendar-header > .dropdown button')
+    I.click('.page.current .calendar-header > .dropdown button')
+    I.waitForText(view, undefined, '.open .dropdown-menu')
+    I.click(locate('.dropdown.open a').withText(view).as('Switch to ' + view))
+    I.wait(2)
+  },
+
+  getFullname (user) {
+    return `${user.get('sur_name')}, ${user.get('given_name')}`
+  },
+
+  async createAppointment ({ subject, location, folder, startDate, startTime, endDate, endTime }) {
+    // select calendar
+    if (folder) {
+      I.selectFolder(folder)
+      I.waitForElement('li.selected[aria-label^="' + folder + '"] .color-label')
+    }
+
+    I.clickPrimary('New appointment')
+    I.waitForVisible(locate('.io-ox-calendar-edit-window').as('Edit Dialog'))
+    await I.waitForFocus('.io-ox-calendar-edit-window input[type="text"][name="summary"]')
+
+    if (folder) {
+      I.see(folder, '.io-ox-calendar-edit-window .folder-selection')
+    }
+    await within('.io-ox-calendar-edit-window', async () => {
+      I.fillField('Title', subject)
+
+      if (location) I.fillField('Location', location)
+
+      if (startDate) {
+        I.click('~Date (M/D/YYYY)')
+        I.pressKey(['Control', 'a'])
+        I.pressKey(startDate)
+        I.pressKey('Enter')
+      }
+
+      if (startTime) {
+        I.click('~Start time')
+        I.click(startTime)
+      }
+
+      if (endDate) {
+        I.click('~Date (M/D/YYYY)', '.dateinput[data-attribute="endDate"]')
+        I.pressKey(['Control', 'a'])
+        I.pressKey(startDate)
+        I.pressKey('Enter')
+      }
+
+      if (endTime) {
+        I.click('~End time')
+        I.click(endTime)
+      }
+
+      // save
+      I.click('Create')
+    })
+    I.waitForDetached('.io-ox-calendar-edit-window')
+  },
+
+  // remove previously created appointments by appointment title
+  async removeAllAppointments (title) {
+    const { skipRefresh } = await I.executeScript(async function (title) {
+      const appointments = [...document.querySelectorAll('.appointment')]
+        .map(el => {
+          const folder = el.getAttribute('data-folder')
+          return { folder, id: el.getAttribute('data-cid').replace(folder + '.', '') }
+        })
+      if (appointments.length === 0) return { skipRefresh: true }
+      const { default: api } = await import(String(new URL('io.ox/calendar/api.js', location.href)))
+      return await api.remove(appointments, {})
+    }, title)
+    if (skipRefresh === true) return
+    I.click('#io-ox-refresh-icon')
+    I.waitForDetached('#io-ox-refresh-icon .fa-spin')
+  },
+
+  async setDateTo (dateString) {
+    await I.executeScript(async function (dateStr) {
+      const { default: apps } = await import(String(new URL('io.ox/core/api/apps.js', location.href)))
+      const { moment } = await import(String(new URL('e2e.js', location.href)))
+      apps.get('io.ox/calendar').setDate(moment(dateStr))
+    }, dateString)
+  }
+}

package/src/pageobjects/contacts.js

@@ -0,0 +1,148 @@
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+const { I, dialogs } = inject()
+
+module.exports = {
+
+  editWindow: '.io-ox-contacts-edit-window',
+
+  selectContact (text) {
+    I.waitForElement(`.vgrid [aria-label="${text}"]`)
+    I.click(`.vgrid [aria-label="${text}"]`)
+    I.waitForElement('.contact-header')
+    I.waitForText(text, undefined, '.contact-header .fullname')
+  },
+
+  selectListItem (text, selector = '.last_name') {
+    I.waitForElement(locate(`.vgrid-cell ${selector}`).withText(text).as(text))
+    I.click(locate(`.vgrid-cell ${selector}`).withText(text).as(text))
+    I.waitForElement(locate(`.contact-detail h1 ${selector}`).withText(text).as(text))
+    I.wait(0.5)
+  },
+
+  newAddressbook (name) {
+    I.click('button.contextmenu-control', '~My address books')
+    I.clickDropdown('Add new address book')
+    dialogs.waitForVisible()
+    I.fillField('[placeholder="New address book"][type="text"]', name)
+    dialogs.clickButton('Add')
+    I.waitForDetached('.modal-dialog')
+  },
+
+  newContact () {
+    I.waitForDetached('.dropdown-toggle.disabled')
+    I.clickPrimary('New contact')
+    I.waitForText('Add personal info')
+  },
+
+  newDistributionlist () {
+    I.waitForDetached('.dropdown-toggle.disabled')
+    const button = locate('.primary-action .btn-group').withText('New contact').as('Primary Dropdown Button: New contact')
+    I.waitForVisible(button)
+    I.click(locate('.dropdown-toggle').inside(button).as('Dropdown Toggle'))
+    I.click('New distribution list', '.primary-action .btn-group > .dropdown-menu')
+    I.waitForText('Participants')
+  },
+
+  addField (fieldType, field) {
+    I.click(`.dropdown[data-add="${fieldType}"] button`, '.contact-edit')
+    I.waitForVisible('.dropdown.open .dropdown-menu')
+    I.click(field)
+    I.waitForText(field, 30, '.contact-edit')
+  },
+
+  editMyAccount () {
+    I.waitForVisible('.dropdown-toggle[aria-label="My account"]')
+    I.waitForVisible('.contact-picture')
+    I.click('.contact-picture')
+    I.waitForText('Edit personal data', 30, '.dropdown.open .dropdown-menu')
+    I.click('Edit personal data', '.dropdown.open .dropdown-menu')
+    I.waitForVisible(this.editWindow)
+  },
+
+  deleteSelected () {
+    I.clickToolbar('Delete')
+    dialogs.waitForVisible()
+    dialogs.clickButton('Delete')
+    I.waitForDetached('.modal-dialog')
+  },
+
+  async hasImage () {
+    const rule = await I.grabCssPropertyFrom('.contact-header .contact-photo', 'background-image')
+    expect(rule).not.to.match(/fallback/)
+    expect(rule).to.match(/^url\(/)
+  },
+
+  importCSV (file, path = 'media/imports/contacts', folder = 'Contacts') {
+    I.rightClick(`~${folder}`)
+    I.clickDropdown('Import')
+    dialogs.waitForVisible()
+    I.selectOption('Format', 'CSV')
+    I.attachFile('.file-input', `${path}/${file}.csv`)
+    dialogs.clickButton('Import')
+    I.waitForDetached('.modal-dialog')
+    I.waitForText('Data imported successfully')
+  },
+
+  importVCF (file, path = 'media/imports/contacts', folder = 'Contacts') {
+    I.rightClick(`~${folder}`)
+    I.clickDropdown('Import')
+    dialogs.waitForVisible()
+    I.selectOption('Format', 'VCARD')
+    I.attachFile('.file-input', `${path}/${file}.vcf`)
+    dialogs.clickButton('Import')
+    I.waitForDetached('.modal-dialog')
+    I.waitForText('Data imported successfully')
+  },
+
+  async exportCSV (file) {
+    I.clickToolbar('More actions')
+    I.clickDropdown('Export')
+    dialogs.waitForVisible()
+    I.checkOption('CSV')
+    I.waitForDownload('.modal-dialog button:has-text("Export")', `${file}.csv`)
+    I.waitForDetached('.modal-dialog')
+  },
+  async exportVCF (file) {
+    I.clickToolbar('More actions')
+    I.clickDropdown('Export')
+    dialogs.waitForVisible()
+    I.checkOption('vCard')
+    I.waitForDownload('.modal-dialog button:has-text("Export")', `${file}.vcf`)
+    I.waitForDetached('.modal-dialog')
+  },
+  async exportAddressBookCSV (file) {
+    I.rightClick('~Contacts')
+    I.clickDropdown('Export')
+    dialogs.waitForVisible()
+    I.checkOption('CSV')
+    I.waitForDownload('.modal-dialog button:has-text("Export")', `${file}.csv`)
+    I.waitForDetached('.modal-dialog')
+  },
+  async exportAddressBookVCF (file) {
+    I.rightClick('~Contacts')
+    I.clickDropdown('Export')
+    dialogs.waitForVisible()
+    I.checkOption('vCard')
+    I.waitForDownload('.modal-dialog button:has-text("Export")', `${file}.vcf`)
+    I.waitForDetached('.modal-dialog')
+  }
+}

package/src/pageobjects/drive.js

@@ -0,0 +1,96 @@
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+const { I, dialogs } = inject()
+
+module.exports = {
+
+  openSecondary () {
+    I.waitForElement('~New')
+    I.click('.primary-action > .dropdown > button')
+    I.waitForElement('.dropdown.open .dropdown-menu')
+  },
+  clickSecondary (name) {
+    this.openSecondary()
+    I.click(name, '.dropdown.open .dropdown-menu')
+  },
+  selectFile (title, { timeout = undefined } = {}) {
+    I.waitForElement(`.filename[title="${title}"]`, timeout)
+    I.click(`.filename[title="${title}"]`)
+    I.wait(0.5) // wait for toolbar rendering
+  },
+  shareFolder (name, role) {
+    I.clickToolbar('Share')
+    dialogs.waitForVisible()
+    I.waitForText('Share folder')
+
+    if (role !== 'Viewer') {
+      I.waitForVisible('.permission-pre-selection .btn')
+      I.click('.permission-pre-selection .btn')
+      I.clickDropdown(role)
+    }
+
+    I.waitForText(role, undefined, '.permission-pre-selection')
+    I.click('~Select contacts')
+
+    // dialog is open
+    dialogs.waitForVisible()
+    I.waitForElement('.modal-body .list-view.address-picker li.list-item') // check if list items are loaded
+    I.fillField('Search', name)
+    I.waitForText(name, undefined, '.modal-dialog .address-picker')
+    I.waitForElement('.address-picker .list-item')
+    I.click('.address-picker .list-item')
+    dialogs.clickButton('Select')
+
+    I.waitForText('Share folder', undefined, dialogs.header)
+    I.waitForText('ADDED', undefined, '.permissions-view .permission.row:first-child .added')
+    I.see('Owner', '.permissions-view .permission.row:last-child')
+    I.see(role, '.permissions-view .permission.row:first-child')
+    I.see('Internal user (' + name + ')', '.permissions-view .permission.row:first-child .description')
+    dialogs.clickButton('Share')
+    I.waitForDetached('.modal-dialog')
+  },
+  moveManuallyTo (destination) {
+    I.clickToolbar('More actions')
+    I.clickDropdown('Move')
+
+    I.waitForElement('.folder-picker-dialog')
+    I.waitForElement(`.folder-picker-dialog [data-id="${destination}"]`)
+    I.click(`.folder-picker-dialog [data-id="${destination}"]`)
+    I.waitForElement(`.folder-picker-dialog [data-id="${destination}"].selected`)
+    I.click('Move', '.folder-picker-dialog')
+    I.waitForDetached('.folder-picker-dialog')
+  },
+  seeListViewIcon (itemName, icon, title) {
+    I.seeElement(`.list-item .filename[title="${itemName}"] ~ .icons span[title="${title}"] .${icon}`)
+  },
+  seeNumberOfListViewIcons (itemName, count) {
+    I.seeNumberOfElements(`.list-item .filename[title="${itemName}"] ~ .icons span`, count)
+  },
+  seeInternalUserInShareSection (userName, email) {
+    I.waitForText(`${userName}${email}`, undefined, '.viewer-shares-info')
+  },
+  seeGuestInShareSection (email) {
+    I.waitForText(`${email}Guest`, undefined, '.viewer-shares-info')
+  },
+  seePublicLinkInShareSection () {
+    I.waitForText('Public link', undefined, '.viewer-shares-info')
+  }
+}

package/src/pageobjects/fragments/contact-autocomplete.js

@@ -0,0 +1,45 @@
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+const { I } = inject()
+
+module.exports = {
+
+  suggestion: locate('.tt-dropdown-menu .tt-suggestion:nth-of-type(1)').as('First suggestion'),
+  suggestions: locate('.tt-dropdown-menu').as('Suggestion dropdown'),
+
+  select (elementName, within) {
+    const context = within === '*' ? '//span[@class="tt-dropdown-menu"]' : `//div[contains(@class, "${within}")]//span[@class="tt-dropdown-menu"]`
+
+    I.waitForText(elementName, 10, context)
+
+    // searched entry could be a resource or user where the DOM structure differs
+    const searchEntry = locate(`${context}//div[@class="participant-name"]/strong[text()="${elementName}"]|//div[@class="participant-email"]/span/strong[text()="${elementName}"]`).as(elementName)
+    I.waitForElement(searchEntry, 10)
+    I.click(searchEntry)
+  },
+
+  selectFirst () {
+    I.waitForVisible(this.suggestion)
+    I.waitForEnabled(this.suggestion)
+    I.click(this.suggestion)
+    I.waitForInvisible(this.suggestions)
+  }
+}

package/src/pageobjects/fragments/contact-picker.js

@@ -0,0 +1,50 @@
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+const { I } = inject()
+
+module.exports = {
+
+  results: locate('.addressbook-popup').find('.list-item').as('Results'),
+
+  ready () {
+    I.waitForVisible('.addressbook-popup')
+  },
+
+  async add (query) {
+    this.ready()
+    await I.waitForFocus('.addressbook-popup .search-field')
+    I.fillField('.addressbook-popup .search-field', query)
+    I.waitForVisible(this.results)
+    this.selectFirst()
+  },
+
+  selectFirst () {
+    I.waitForEnabled(this.results)
+    I.waitForEnabled(this.results.first().as('First list item'))
+    I.click(this.results.first().as('First list item'))
+    I.waitForVisible(locate('.list-item.selected').as('Selected list item'))
+  },
+
+  close () {
+    I.click('Select')
+    I.waitToHide('.addressbook-popup')
+  }
+}

package/src/pageobjects/fragments/dialogs.js

@@ -0,0 +1,41 @@
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+const { I } = inject()
+
+module.exports = {
+
+  main: locate('.modal:not(.hidden):not(.modal-paused) .modal-dialog').as('Modal Main'),
+  header: locate('.modal:not(.hidden):not(.modal-paused) .modal-header').as('Modal Header'),
+  body: locate('.modal:not(.hidden):not(.modal-paused) .modal-body').as('Modal Body'),
+  footer: locate('.modal:not(.hidden):not(.modal-paused) .modal-footer').as('Modal Footer'),
+
+  clickButton (label) {
+    const buttonLocator = locate('.modal:not(.hidden):not(.modal-paused) .modal-footer button').withText(label).as(label)
+    I.waitForVisible(buttonLocator)
+    I.click(label, this.footer)
+  },
+
+  waitForVisible () {
+    // wait for modal dialog to be visible an ready
+    I.waitForVisible(this.main)
+    I.waitForInvisible(locate('.modal:not(.hidden):not(.modal-paused)').find('.io-ox-busy').as('Modal Busy'), 30)
+  }
+}

package/src/pageobjects/fragments/search.js

@@ -0,0 +1,54 @@
+/**
+ * @copyright Copyright (c) Open-Xchange GmbH, Germany <info@open-xchange.com>
+ * @license AGPL-3.0
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with OX App Suite. If not, see <https://www.gnu.org/licenses/agpl-3.0.txt>.
+ *
+ * Any use of the work other than as authorized under this license or copyright law is prohibited.
+ */
+
+const { I } = inject()
+
+module.exports = {
+
+  searchField: locate('#io-ox-topsearch .search-field').as('Search field'),
+  dropdownToggle: locate('#io-ox-topsearch .dropdown-toggle').as('Toggle'),
+  dropdown: locate('#io-ox-topsearch .dropdown').as('Dropdown'),
+  submitButton: locate('#io-ox-topsearch .dropdown [type="submit"]').as('Submit Button'),
+
+  openDropdown () {
+    I.waitForVisible(this.dropdownToggle)
+    I.click(this.dropdownToggle)
+    I.waitForVisible(this.dropdown)
+  },
+
+  // introducing methods
+  doSearch (query) {
+    I.waitForElement('#io-ox-topsearch .search-field')
+    I.waitForVisible('#io-ox-topsearch .search-field')
+    I.fillField('#io-ox-topsearch .search-field', query)
+    I.fillField('#io-ox-topsearch .search-field', query)
+    I.pressKey('Enter')
+    I.waitForText('Search results')
+    I.waitToHide('.list-view .busy-indicator.io-ox-busy')
+  },
+
+  cancel () {
+    I.click(this.searchField)
+    I.clearField(this.searchField)
+    I.pressKey('Enter')
+    I.waitForInvisible('Search results')
+    I.wait(0.5)
+  }
+}