nextcloud/tests/acceptance/features/bootstrap/FilesSharingAppContext.php
Daniel Calviño Sánchez fcd6cf08e0 Generalize file list steps so a specific ancestor can be used
The "FileListContext" provides steps to interact with and check the
behaviour of a file list. However, the "FileListContext" does not know
the right file list ancestor that has to be used by the file list steps,
so until now the file list steps were explicitly wired to the Files app
and they could be used only in that case.

Instead of duplicating the steps with a slightly different name (for
example, "I create a new folder named :folderName in the public shared
folder" instead of "I create a new folder named :folderName") the steps
were generalized; now contexts that "know" that certain file list
ancestor has to be used by the FileListContext steps performed by
certain actor from that point on (until changed again) set it
explicitly. For example, when the current page is the Files app then the
ancestor of the file list is the main view of the current section of the
Files app, but when the current page is a shared link then the ancestor
is set to null (because there will be just one file list, and thus its
ancestor is not relevant to differentiate between instances)

A helper trait, "FileListAncestorSetter", was introduced to reduce the
boilerplate needed to set the file list ancestor from other contexts.

Signed-off-by: Daniel Calviño Sánchez <danxuliu@gmail.com>
2018-03-09 03:37:08 +01:00

222 lines
6.9 KiB
PHP

<?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() {
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("share-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")->
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");
}
/**
* @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/preview",
$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/download",
$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 (!$this->waitForElementToBeEventuallyShown(
self::shareMenu(), $timeout = 10 * $this->actor->getFindTimeoutMultiplier())) {
PHPUnit_Framework_Assert::fail("The Share menu is not visible yet after $timeout seconds");
}
PHPUnit_Framework_Assert::assertTrue(
$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 shared file preview shows the text :text
*/
public function iSeeThatTheSharedFilePreviewShowsTheText($text) {
PHPUnit_Framework_Assert::assertContains($text, $this->actor->find(self::textPreview(), 10)->getText());
}
private function waitForElementToBeEventuallyShown($elementLocator, $timeout = 10, $timeoutStep = 1) {
$actor = $this->actor;
$elementShownCallback = function() use ($actor, $elementLocator) {
try {
return $actor->find($elementLocator)->isVisible();
} catch (NoSuchElementException $exception) {
return false;
}
};
return Utils::waitFor($elementShownCallback, $timeout, $timeoutStep);
}
}