Cypress.dom

Cypress.dom.method() — это набор вспомогательных методов, связанных с DOM.

На самом деле, к Cypress.dom прикреплено множество методов, которые не документированы ниже. Эти методы используются внутри Cypress практически в каждой встроенной команде.

Мы рекомендуем прочитать исходный код здесь, чтобы увидеть все методы и их назначение.

Синтаксис

Cypress.dom.isHidden(element)

Примеры

Прикреплён

Возвращает логическое значение, указывающее, прикреплён ли элемент к DOM.

cy.get('button').then(($el) => {
  Cypress.dom.isAttached($el) // true
})

Является потомком

Возвращает логическое значение, указывающее, является ли элемент потомком другого элемента.

cy.get('div').then(($el) => {
  Cypress.dom.isDescendent($el.parent(), $el) // true
})

Откреплён

Возвращает логическое значение, указывающее, откреплён ли элемент от DOM.

cy.get('button').then(($el) => {
  Cypress.dom.isDetached($el) // false
})

Тип документа

Возвращает логическое значение, указывающее, является ли узел документом.

cy.get('p').then(($el) => {
  Cypress.dom.isDocument($el) // false
})

Объект DOM

Возвращает логическое значение, указывающее, является ли объект объектом DOM.

cy.get('body').then(($el) => {
  Cypress.dom.isDom($el) // true
})

Элемент DOM

Возвращает логическое значение, указывающее, является ли объект элементом DOM.

cy.get('p').then(($el) => {
  Cypress.dom.isElement($el) // true
})

Фокусируемый

Возвращает логическое значение, указывающее, может ли элемент получить фокус.

Cypress внутренне использует этот метод везде, чтобы определить, скрыт ли элемент, в основном для возможности взаимодействия.

cy.get('input').then(($el) => {
  Cypress.dom.isFocusable($el) // true
})

Сфокусирован

Возвращает логическое значение, указывающее, имеет ли элемент в данный момент фокус.

cy.get('button').then(($el) => {
  Cypress.dom.isFocused($el)
})

Скрытый

Возвращает логическое значение, указывающее, скрыт ли элемент.

Cypress внутренне использует этот метод везде, чтобы определить, скрыт ли элемент, в основном для возможности взаимодействия.

cy.get('p').then(($el) => {
  Cypress.dom.isHidden($el) // false
})

Объект jQuery

Возвращает логическое значение, указывающее, является ли объект объектом jQuery.

cy.get('input').then(($el) => {
  Cypress.dom.isJquery($el)
})

Прокручиваемый

Возвращает логическое значение, указывающее, может ли элемент быть прокручен.

Cypress внутренне использует этот метод везде, чтобы определить, может ли элемент быть прокручен, в основном для возможности взаимодействия.

cy.get('body').then(($el) => {
  Cypress.dom.isScrollable($el) // true
})

Видимый

Возвращает логическое значение, указывающее, виден ли элемент.

cy.get('img').then(($el) => {
  Cypress.dom.isVisible($el) // true
})

Подсказка: если тест Cypress завершается ошибкой "элемент не виден", но вы уверены, что элемент должен быть видимым, вы можете отладить проверку видимости самостоятельно, пройдя по коду Cypress.dom.isVisible, см. Отладка проблем с видимостью элементов в Cypress.

Объект окна

Возвращает логическое значение, указывающее, является ли объект объектом окна.

cy.get(window).then(($el) => {
  Cypress.dom.isWindow($el) // true
})

Развернуть

Возвращает массив исходных элементов, извлечённых из объекта jQuery.

cy.get('body').then(($el) => {
  Cypress.dom.unwrap($el)
})

Обернуть

Возвращает объект jQuery, полученный путём обертывания объекта в jQuery.

cy.get('p').then(($el) => {
  Cypress.dom.wrap($el)
})

См. также

• Прочитайте блог-запись Отладка проблем с видимостью элементов в Cypress, чтобы узнать, как вы можете вызвать эти методы из консоли DevTools для прохождения их логики.