---
id: api/cypress-api/currenttest
title: Cypress.currentTest | Cypress Documentation
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: 24a73f8a97175663aaffd3b016289fb2a523a4ea
updated_at: '2026-05-14T20:17:33.301Z'
---
# 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 propertiesCypress.currentTest// the title of the current testCypress.currentTest.title// an array with the current test's title pathCypress.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 |