первый

Получите первый DOM-элемент в наборе DOM-элементов.

Поведение запроса этой команды точно соответствует тому, как работает .first() в jQuery.

Синтаксис

.first()
.first(options)

Использование

Правильное использование

cy.get('nav a').first() // Yield first link in nav

Неправильное использование

cy.first() // Errors, cannot be chained off 'cy'
cy.getCookies().first() // Errors, 'getCookies' does not yield DOM element

Аргументы

options (Объект)

Передайте объект options, чтобы изменить стандартное поведение .first().

Возвращаемое значение

• .first() возвращает новый найденный DOM-элемент(ы).

Примеры

Без аргументов

Получение первого элемента списка в списке

<ul>
  <li class="one">Knick knack on my thumb</li>
  <li class="two">Knick knack on my shoe</li>
  <li class="three">Knick knack on my knee</li>
  <li class="four">Knick knack on my door</li>
</ul>

// yields <li class="one">Knick knack on my thumb</li>
cy.get('li').first()

Правила

Требования

• .first() требует цепочки команд, возвращающих DOM-элемент(ы).

Утверждения

• .first() автоматически повторно выполнится до тех пор, пока элемент(ы) не будут существовать в DOM
• .first() автоматически повторно выполнится до тех пор, пока все цепочные утверждения не пройдут

Таймауты

• .first() может выйти из строя, ожидая, пока элемент(ы) будут существовать в DOM .
• .first() может выйти из строя, ожидая, пока утверждения пройдут.

Журнал команд

Найти первый элемент ввода в форме

cy.get('form').find('input').first()

Команды выше будут отображены в журнале команд как:

При нажатии на first в журнале команд консоль выведет следующее:

См. также

• .eq()
• .last()