log.mdx

title	description	sidebar_label	slug
log | Cypress Documentation	Print a message to the Cypress Command Log.	log	/api/commands/log

log

Print a message to the Cypress Command Log.

Syntax

cy.log(message)cy.log(message,args...)

Usage

Correct Usage

cy.log('created new user')

Arguments

message (String)

Message to be printed to Cypress Command Log. Accepts a Markdown formatted message.

args...

Additional arguments to be printed to the Cypress Command Log. There is no limit to the number of arguments.

• cy.log() yields null.

Examples

Message

Print a message to the Command Log.

cy.click('Login')cy.log('Login successful')

Args

Print a message with arguments to the Command Log.

cy.log('events triggered',events)

Rules

• cy.log() requires being chained off of cy.

• cy.log() cannot have any assertions chained.

• cy.log() cannot time out.

Command Log

Print messages with arguments to the Command Log.

cy.log('log out any message we want here')cy.log('another message',['one','two','three'])

The commands above will display in the Command Log as:

When clicking on log within the command log, the console outputs the following:

See also

• cy.exec()
• Cypress.log
• cy.task()