server/tests/acceptance/features/bootstrap/FilesSharingAppContext.php

252 lines
7.8 KiB
PHP
Raw Normal View History

<?php
/**
*
* @copyright Copyright (c) 2017, Daniel Calviño Sánchez (danxuliu@gmail.com)
*
* @license GNU AGPL version 3 or any later version
*
* This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
use Behat\Behat\Context\Context;
class FilesSharingAppContext implements Context, ActorAwareInterface {
use ActorAware;
use FileListAncestorSetter;
/**
* @return Locator
*/
public static function passwordField() {
return Locator::forThe()->field("password")->
describedAs("Password field in Authenticate page");
}
/**
* @return Locator
*/
public static function authenticateButton() {
return Locator::forThe()->id("password-submit")->
describedAs("Authenticate button in Authenticate page");
}
/**
* @return Locator
*/
public static function wrongPasswordMessage() {
Remove "content" locator from acceptance tests The "content" locator uses the "named" Mink selector and the "content" Mink locator to find the element. The "named" Mink first tries to find the elements whose content match exactly the given content but, if none is found, then it tries to find elements that just contain the given content. This behaviour can lead to hard to track issues. Finding the exact match and, if not found, finding the partial match is done in quick succession. In most cases, when looking for an exact match the element is already there, it is returned, and everything works as expected. Or it may not be there, but then it is not there either when finding the partial match, so no element is returned, and everything works as expected (that is, the actor tries to find again the element after some time). However, it can also happen that when looking for an exact match there is no element yet, but it appears after trying to find the exact match but before trying to find the partial match. In that situation the desired element would be returned along with its ancestors. However, as only the first found element is taken into account and the ancestors would appear first the find action would be successful, but the returned element would not be the expected one. This is highly unlikely, yet possible, and can cause sporadic failures in acceptance tests that, apparently, work as expected. Using a "named_exact" Mink selector instead of the "named" Mink selector does not provide the desired behaviour in most cases either. As it finds any element whose content matches exactly the given content, looking for "Hello world" in "<div><p><a>Hello world</a></p></div>" would match the "div", "p" and "a" elements; in that situation the "div" element would be the one returned, when typically the "a" element would be the expected one. As it is error prone and easily replaceable by more robust locators the "content" locator was removed from the predefined ones (although it can still be used if needed through the "customSelector" method in the builder object). Signed-off-by: Daniel Calviño Sánchez <danxuliu@gmail.com>
2017-05-02 10:49:27 +00:00
return Locator::forThe()->xpath("//*[@class = 'warning' and normalize-space() = 'The password is wrong. Try again.']")->
describedAs("Wrong password message in Authenticate page");
}
/**
* @return Locator
*/
public static function shareMenuButton() {
return Locator::forThe()->id("header-actions-toggle")->
describedAs("Share menu button in Shared file page");
}
/**
* @return Locator
*/
public static function shareMenu() {
return Locator::forThe()->id("header-actions-menu")->
describedAs("Share menu in Shared file page");
}
/**
* @return Locator
*/
public static function downloadItemInShareMenu() {
return Locator::forThe()->id("download")->
descendantOf(self::shareMenu())->
describedAs("Download item in Share menu in Shared file page");
}
/**
* @return Locator
*/
public static function directLinkItemInShareMenu() {
return Locator::forThe()->id("directLink-container")->
descendantOf(self::shareMenu())->
describedAs("Direct link item in Share menu in Shared file page");
}
/**
* @return Locator
*/
public static function saveItemInShareMenu() {
return Locator::forThe()->id("save-external-share")->
descendantOf(self::shareMenu())->
describedAs("Save item in Share menu in Shared file page");
}
/**
* @return Locator
*/
public static function textPreview() {
return Locator::forThe()->css(".text-preview")->
describedAs("Text preview in Shared file page");
}
/**
* @return Locator
*/
public static function downloadButton() {
return Locator::forThe()->id("downloadFile")->
describedAs("Download button in Shared file page");
}
/**
* @When I visit the shared link I wrote down
*/
public function iVisitTheSharedLinkIWroteDown() {
$this->actor->getSession()->visit($this->actor->getSharedNotebook()["shared link"]);
}
/**
* @When I visit the direct download shared link I wrote down
*/
public function iVisitTheDirectDownloadSharedLinkIWroteDown() {
$this->actor->getSession()->visit($this->actor->getSharedNotebook()["shared link"] . "/download");
}
/**
* @When I authenticate with password :password
*/
public function iAuthenticateWithPassword($password) {
$this->actor->find(self::passwordField(), 10)->setValue($password);
$this->actor->find(self::authenticateButton())->click();
}
/**
* @When I open the Share menu
*/
public function iOpenTheShareMenu() {
$this->actor->find(self::shareMenuButton(), 10)->click();
}
/**
* @Then I see that the current page is the Authenticate page for the shared link I wrote down
*/
public function iSeeThatTheCurrentPageIsTheAuthenticatePageForTheSharedLinkIWroteDown() {
PHPUnit_Framework_Assert::assertEquals(
$this->actor->getSharedNotebook()["shared link"] . "/authenticate/showShare",
$this->actor->getSession()->getCurrentUrl());
}
/**
* @Then I see that the current page is the Authenticate page for the direct download shared link I wrote down
*/
public function iSeeThatTheCurrentPageIsTheAuthenticatePageForTheDirectDownloadSharedLinkIWroteDown() {
PHPUnit_Framework_Assert::assertEquals(
$this->actor->getSharedNotebook()["shared link"] . "/authenticate/downloadShare",
$this->actor->getSession()->getCurrentUrl());
}
/**
* @Then I see that the current page is the shared link I wrote down
*/
public function iSeeThatTheCurrentPageIsTheSharedLinkIWroteDown() {
PHPUnit_Framework_Assert::assertEquals(
$this->actor->getSharedNotebook()["shared link"],
$this->actor->getSession()->getCurrentUrl());
$this->setFileListAncestorForActor(null, $this->actor);
}
/**
* @Then I see that the current page is the direct download shared link I wrote down
*/
public function iSeeThatTheCurrentPageIsTheDirectDownloadSharedLinkIWroteDown() {
PHPUnit_Framework_Assert::assertEquals(
$this->actor->getSharedNotebook()["shared link"] . "/download",
$this->actor->getSession()->getCurrentUrl());
}
/**
* @Then I see that a wrong password for the shared file message is shown
*/
public function iSeeThatAWrongPasswordForTheSharedFileMessageIsShown() {
PHPUnit_Framework_Assert::assertTrue(
$this->actor->find(self::wrongPasswordMessage(), 10)->isVisible());
}
/**
* @Then I see that the Share menu is shown
*/
public function iSeeThatTheShareMenuIsShown() {
// Unlike other menus, the Share menu is always present in the DOM, so
// the element could be found when it was no made visible yet due to the
// command not having been processed by the browser.
if (!WaitFor::elementToBeEventuallyShown(
$this->actor, self::shareMenu(), $timeout = 10 * $this->actor->getFindTimeoutMultiplier())) {
PHPUnit_Framework_Assert::fail("The Share menu is not visible yet after $timeout seconds");
}
// The acceptance tests are run in a window wider than the mobile breakpoint, so the
// download item should not be shown in the menu (although it will be in
// the DOM).
PHPUnit_Framework_Assert::assertFalse(
$this->actor->find(self::downloadItemInShareMenu())->isVisible());
PHPUnit_Framework_Assert::assertTrue(
$this->actor->find(self::directLinkItemInShareMenu())->isVisible());
PHPUnit_Framework_Assert::assertTrue(
$this->actor->find(self::saveItemInShareMenu())->isVisible());
}
/**
* @Then I see that the Share menu button is not shown
*/
public function iSeeThatTheShareMenuButtonIsNotShown() {
try {
PHPUnit_Framework_Assert::assertFalse(
$this->actor->find(self::shareMenuButton())->isVisible());
} catch (NoSuchElementException $exception) {
}
}
/**
* @Then I see that the shared file preview shows the text :text
*/
public function iSeeThatTheSharedFilePreviewShowsTheText($text) {
PHPUnit_Framework_Assert::assertContains($text, $this->actor->find(self::textPreview(), 10)->getText());
}
/**
* @Then I see that the download button is shown
*/
public function iSeeThatTheDownloadButtonIsShown() {
if (!WaitFor::elementToBeEventuallyShown(
$this->actor, self::downloadButton(), $timeout = 10 * $this->actor->getFindTimeoutMultiplier())) {
PHPUnit_Framework_Assert::fail("The download button is not visible yet after $timeout seconds");
}
}
/**
* @Then I see that the download button is not shown
*/
public function iSeeThatTheDownloadButtonIsNotShown() {
try {
PHPUnit_Framework_Assert::assertFalse(
$this->actor->find(self::downloadButton())->isVisible());
} catch (NoSuchElementException $exception) {
}
}
}