---
id: api/cypress-api/currenttest
title: Cypress.currentTest
description: >-
  Cypress.currentTest is an object representing the currently executing test
  instance, with properties to access the title of the test.
section: api
source_path: docs/api/cypress-api/currenttest.mdx
version: 29f95bf8bb06f320986f3749f5bf09a35a409eab
updated_at: '2026-09-04T10:49:54.630Z'
---
# Cypress.currentTest

`Cypress.currentTest` is an object representing the currently executing test instance, with properties to access the title of the test.

Note that `Cypress.currentTest` may only be used inside tests and [test hooks](/llm/markdown/app/core-concepts/writing-and-organizing-tests.md#Hooks), and will be `null` outside of tests and test hooks.

## Syntax

```
// an object with title and titlePath properties
Cypress.currentTest

// the title of the current test
Cypress.currentTest.title

// an array with the current test's title path
Cypress.currentTest.titlePath
```

## Examples

### Get current test title

```
describe('app layout and responsiveness', () => {
  it('toggles the nav', () => {
    expect(Cypress.currentTest.title).to.eq('toggles the nav')
  })
})
```

### Get full path of current test title

```
describe('app layout and responsiveness', () => {
  it('toggles the nav', () => {
    expect(Cypress.currentTest.titlePath).to.deep.eq([
      'app layout and responsiveness',
      'toggles the nav',
    ])
  })
})
```

## History

| Version | Changes |
| --- | --- |
| [8.2.0](/llm/markdown/app/references/changelog.md#8-2-0) | `Cypress.currentTest` added |