This is my work to fix https://github.com/minkphp/docs/issues/33

I'm not yet done on it (everything after the .. todo:: directive is still the old content). I will update the PR later with the end of the chapter.

It currently redirects to the Behat/Mink repo on Github. This will become wrong anyway when moving the code to the minkphp organization. We should update the domain to point to RTD

I am having problem running mink + behat combo. The scenario looks as follows:

@javascript @insulated
Feature: Login
  Scenario: Login valid
    Given I am on "/auth/login"
    When I fill in the following:
      | email | xxx |
      | pass_hash | xxx |
    And I press "Sign in"
    Then I should be on "/dashboard"

  Scenario: Login invalid
    Given I am on "/auth/login"
    When I fill in the following:
      | email | yyy |
      | pass_hash | yyy |
    And I press "Sign in"
    Then I should see "Wrong e-mail or password."

And I get the following result https://gist.github.com/rgembalik/fe7e8dbbe53d2ee8669b

behat.yml looks like this:

default:
    extensions:
        mink_extension.phar:
            mink_loader: mink.phar
            base_url: http://localhost/testpage
            goutte: ~
            selenium2:
                wd_host: http://127.0.0.1:4444/wd/hub
                capabilities:
                  version: ''

Selenium session is created and firefox is launching, but no url is inserted. Sessions stays registered in selenium (it is visible under http://127.0.0.1:4444/wd/hub).

Any idea and/or suggestions?

EDIT: BTW, when I try it without @javascript @insulated it works just fine and the test passes. I have problems only with selenium.

ReadtheDocs now supports HTTPS for custom domains, but this requires migrating the CNAME to the new target (old CNAMEs don't support it).

@everzet as you are the one controlling the DNS of the domain (at least as far as I know), could you update it to point at readthedocs.io ? https://docs.readthedocs.io/en/stable/custom_domains.html#custom-domain-ssl

The focus should not be on the SelectorsHandler class (most users will not need to deal with it directly. It is an internal API). We should start from the user-facing API instead (i.e. Element::find and Element::findAll)

Currently, the Selenium Driver setValue method includes the following at the bottom:

$value = strval($value);

if (in_array($elementName, array('input', 'textarea'))) {
  $existingValueLength = strlen($element->attribute('value'));
  // Add the TAB key to ensure we unfocus the field as browsers are triggering the change event only
  // after leaving the field.
  $value = str_repeat(Key::BACKSPACE . Key::DELETE, $existingValueLength) . $value . Key::TAB;
}

$element->postValue(array('value' => array($value)));

There is no option given to exclude the tab key from the posted value, as it is presumed to be necessary to trigger the change event. In my work with Drupal 7's autocomplete field, however, the field reacts to the onChange event, and the tab will submit the value. In fields where the user must choose one of the predefined values, this causes an exception.

I'd like to be able to optionally not add the tab key to the input. Something akin to:

**
 * {@inheritdoc}
 */
public function setValue($xpath, $value, $options=array()) {
  $options = $options + array(
    'addTab'=>TRUE
  );
  $element = $this->findElement($xpath);
  $elementName = strtolower($element->name());

  if ('select' === $elementName) {
    if (is_array($value)) {
      $this->deselectAllOptions($element);

      foreach ($value as $option) {
        $this->selectOptionOnElement($element, $option, TRUE);
      }

      return;
    }

    $this->selectOptionOnElement($element, $value);

    return;
  }

  if ('input' === $elementName) {
    $elementType = strtolower($element->attribute('type'));

    if (in_array($elementType, array('submit', 'image', 'button', 'reset'))) {
      throw new DriverException(sprintf('Impossible to set value an element with XPath "%s" as it is not a select, textarea or textbox', $xpath));
    }

    if ('checkbox' === $elementType) {
      if ($element->selected() xor (bool) $value) {
        $this->clickOnElement($element);
      }

      return;
    }

    if ('radio' === $elementType) {
      $this->selectRadioValue($element, $value);

      return;
    }

    if ('file' === $elementType) {
      $element->postValue(array('value' => array(strval($value))));

      return;
    }
  }

  $value = strval($value);

  if (in_array($elementName, array('input', 'textarea'))) {
    $existingValueLength = strlen($element->attribute('value'));
    // Add the TAB key to ensure we unfocus the field as browsers are triggering the change event only
    // after leaving the field.
    $value = str_repeat(Key::BACKSPACE . Key::DELETE, $existingValueLength) . $value . (($options['addTab']) ? Key::TAB : '');
  }

  $element->postValue(array('value' => array($value)));
}

A diff of the file from the original with these changes would be:

290d289
< 
636d634
<   public function setValue($xpath, $value) {
637a636,639
>   public function setValue($xpath, $value, $options=array()) {
>     $options = $options + array(
>       'addTab'=>TRUE
>     );
691c693
<       $value = str_repeat(Key::BACKSPACE . Key::DELETE, $existingValueLength) . $value . Key::TAB;

---
>       $value = str_repeat(Key::BACKSPACE . Key::DELETE, $existingValueLength) . $value . (($options['addTab']) ? Key::TAB : '');

I'm experiencing an issue using Mink to control Firefox through Sahi where when I try to interact with the session in any way (e.g. running getPage()->getContent() or simply wait(2000)) I don't get the expected response and Mink eventually times out.

I've used the exact same code for various other websites and it works perfectly. This one single website seems to be stopping either Mink or Sahi from providing a response. I can't seem to find any reliable way of debugging the issue, all I can do is wait for the timeout to occur.

The code I'm using to retrieve the markup from a page is as follows:

// Configure driver
$this->driver = new \Behat\Mink\Driver\SahiDriver('firefox',
    new \Behat\SahiClient\Client(
        new \Behat\SahiClient\Connection(null, CRAWL_SERVER, 9999)
    )
);

// Init session:
$this->session = new \Behat\Mink\Session($this->driver);

// Start session:
$this->session->start();

// Open the url
$this->session->visit($config['url']);

// Get the markup from the page
$markup = $this->session->getPage()->getContent();

The page I'm trying to scrape is: https://www.o2.co.uk/shop/phones/

I also have a post up on on Stack Overflow here.

I'm using Mink 1.6 - installed using composer on 27/11/2014

tl;dr Why is Mink/Sahi timing out on this site?

The content is still the same. This change is focusing on moving it around to split the doc into multiple pages. The order of the toctree is also meant to put the emphasis on the Session and Element rather than on the driver like previously, because the driver is the internal API of Mink and beginners should never need to deal with it except for the instantiation.

Next steps are now to rewrite each chapter to bring it uptodate and make it better (for instance making the Session chapter describe it as a main API rather than as a convenience layer on top of the driver, which is not described previously anymore). This will be done in separate PRs after this one is merged as it is easier when having multiple page.

Grammatical error. In English, when you have a large amount of something, the 'something' has to be an 'uncountable' thing, such as sand or water, or sunshine. If you have a large number of things that are countable, such as 'browsers' or bricks, or cars then it should be "A large number of "

The page about the Session needs to be rewritten. It should describe it as the main API of Mink rather than as a convenience layer on top of the driver

I found xvfb-run chromedriver --port=4444 to work ... where google-chrome-stable --headless did not. I am not expert on this, I am just reporting and asking: would this be useful in the documentation?

Hi. I'm integrating with an VueJS app and when I call $inputNode->setValue('test') I see the "test" string in the input, but when I click to submit form, for example, it's like the input was never inputed. In other words, vuejs can't get the input was changed.

Someone can show me a light? Thanks.

On http://mink.behat.org/en/latest/guides/interacting-with-pages.html there are several occurrences of text like this:

Looks for a button (see findButton) and presses on it.

The 'see function' should ideally be a link.

I have written my first test this last week using Mink and Chromedriver and it really is not clear Chromedriver is async (it wasn't always so although it's been more 4.5 years since they switched). If this pull request is accepted, I will add notes to some method doxygen as well and perhaps provide sample code. Drupal 8.5.0 has

public function waitForElement($selector, $locator, $timeout = 10000) {
  $page = $this->session->getPage();

  $result = $page->waitFor($timeout / 1000, function () use ($page, $selector, $locator) {
    return $page->find($selector, $locator);
  });

  return $result;
}

which is really helpful, what would be a good place to put this in the Mink documentation -- or perhaps the codebase?

The managing-sessions page says that the Mink class starts the session automatically when getting it. This is not true anymore since the change to auto-start the session when visiting a page.