mirror of
https://github.com/cypress-io/cypress.git
synced 2026-05-19 14:49:43 -05:00
Loren Norman
78 lines
1.7 KiB
Markdown
78 lines
1.7 KiB
Markdown
---
|
|
title: debug
|
|
comments: false
|
|
---
|
|
|
|
Set a `debugger` and log what the previous command yields.
|
|
|
|
{% note warning %}
|
|
You need to have your Developer Tools open for `.debug()` to hit the breakpoint.
|
|
{% endnote %}
|
|
|
|
# Syntax
|
|
|
|
```javascript
|
|
.debug()
|
|
.debug(options)
|
|
```
|
|
|
|
## Usage
|
|
|
|
`.debug()` can be chained off of `cy` or any cy command.
|
|
|
|
**{% fa fa-check-circle green %} Valid Usage**
|
|
|
|
```javascript
|
|
cy.debug().getCookie('app') // Pause to debug at beginning of commands
|
|
cy.get('nav').debug() // Debug the `get` command's yield
|
|
```
|
|
|
|
## Arguments
|
|
|
|
**{% fa fa-angle-right %} options** ***(Object)***
|
|
|
|
Pass in an options object to change the default behavior of `.debug()`.
|
|
|
|
Option | Default | Notes
|
|
--- | --- | ---
|
|
`log` | `true` | Whether to display command in Command Log
|
|
|
|
## Yields
|
|
|
|
`.debug()` yields the previous command's yield.
|
|
|
|
## Timeout
|
|
|
|
# Examples
|
|
|
|
## Debug
|
|
|
|
**Pause with debugger after `.get()`**
|
|
|
|
```javascript
|
|
cy.get('a').debug().should('have.attr', 'href')
|
|
```
|
|
|
|
# Command Log
|
|
|
|
**Log out the current subject for debugging**
|
|
|
|
```javascript
|
|
cy.get(".ls-btn").click({ force: true }).debug()
|
|
```
|
|
|
|
The commands above will display in the command log as:
|
|
|
|
<img width="466" alt="screen shot 2017-05-24 at 4 10 23 pm" src="https://cloud.githubusercontent.com/assets/1271364/26423391/896b858e-409b-11e7-91ce-14c5bf38ab11.png">
|
|
|
|
When clicking on the `debug` command within the command log, the console outputs the following:
|
|
|
|
<img width="572" alt="screen shot 2017-05-24 at 4 10 08 pm" src="https://cloud.githubusercontent.com/assets/1271364/26423392/89725486-409b-11e7-94d5-aebdffe16abf.png">
|
|
|
|
# See also
|
|
|
|
- [Cypress Dashboard](https://on.cypress.io/dashboard)
|
|
- {% url `.pause()` pause %}
|
|
- {% url `cy.log()` log %}
|
|
- {% url `cy.screenshot()` screenshot %}
|