---
id: api/cypress-api/require
title: Cypress.require | Cypress Documentation
description: Utilize dependencies within the cy.origin() callback function in Cypress.
section: api
source_path: docs/api/cypress-api/require.mdx
version: 48b03b5502f7aea1d0454750cce208f775403542
updated_at: '2026-05-20T19:00:20.270Z'
---
# Cypress.require

`Cypress.require` enables utilizing dependencies within the [`cy.origin()`](/llm/markdown/api/commands/origin.md) callback function. It is used to require modules such as [npm](https://www.npmjs.com/) packages and other local files.

It is functionally the same as using [CommonJS `require()`](https://nodejs.org/api/modules.html#requireid) in browser-targeted code.

## Syntax

Using `Cypress.require()` within the [`cy.origin()`](/llm/markdown/api/commands/origin.md) callback requires enabling the [`experimentalOriginDependencies`](/llm/markdown/app/references/experiments.md#End-to-End-Testing) option in the Cypress configuration.

```
Cypress.require('moduleNameOrPath')
```

## Usage

**Correct Usage**

```
cy.origin('cypress.io', () => {  const _ = Cypress.require('lodash')  const utils = Cypress.require('./utils')  // ... use lodash and utils ...})
```

**Incorrect Usage**

```
// `Cypress.require()` cannot be used outside the `cy.origin()` callback.// Use CommonJS `require()` insteadconst _ = Cypress.require('lodash')cy.origin('cypress.io', async () => {  // `require()` and `import()` cannot be used inside the `cy.origin()` callback.  // Use `Cypress.require()` instead  const _ = require('lodash')  const utils = await import('./utils')})// `Cypress.require` must be passed a static string; dynamic values will not// import correctly.cy.origin('cypress.io', { args: { lodash: 'lodash' } }, ({ lodash }) => {  const _ = Cypress.require(lodash)})
```

See [`cy.origin()` Dependencies / Sharing Code](/llm/markdown/api/commands/origin.md#Dependencies--Sharing-Code) for more example usage.

## TypeScript

There are couple ways to have types inferred for the dependency required.

### Casting

```
cy.origin('cypress.io', async () => {  const _ = Cypress.require('lodash') as typeof import('lodash')  // lodash methods are properly typed  _.map([1, 2, 3], (num: number) => {    // ...  })})
```

### Generic

```
import type { LoDashStatic } from 'lodash'cy.origin('cypress.io', async () => {  const _ = Cypress.require < LoDashStatic > 'lodash'  // lodash methods are properly typed  _.map([1, 2, 3], (num: number) => {    // ...  })})
```

## Limitations / Requirements

*   `Cypress.require` only works when called within the [`cy.origin()`](/llm/markdown/api/commands/origin.md) callback function. It will error if used elsewhere.
*   Only the following file extensions are supported for dependencies required (either directly or indirectly):
    *   `.js`
    *   `.jsx`
    *   `.ts`
    *   `.tsx`
    *   `.mjs`
    *   `.json`
    *   `.coffee`
*   `Cypress.require('dependency-name')` must be on one line as a continuous string, and the dependency cannot be dynamically defined:

```
// ✅ GOODCypress.require('lodash')// ❌ BADconst { require } = Cypressrequire('lodash')// ❌ BADCypress.require('lodash')// ❌ BADCypress . require('lodash')// ❌ BADCypress.require(  'lodash')// ❌ BADconst lodashPkgName = 'lodash'Cypress.require(lodashPkgName)
```

## Why not `require` or `import`?

Cypress runs test code in the browser, so any dependencies have to be bundled with the test code before it is run. This is accomplished for the majority of test code via a [preprocessor](/llm/markdown/api/node-events/preprocessors-api.md). However, due to the way that [`cy.origin()`](/llm/markdown/api/commands/origin.md) works, the callback passed to it is extracted from the test code where it is defined and run in a different context. This also separates it from any dependencies that are included in the test code bundle.

To solve this, we replace all instances of `Cypress.require` with `require` at runtime and bundle just the callback with any dependencies required within it.

Using `Cypress.require` in the test code instead of `require` or `import` keeps the dependencies required within the callback from being bundled with the rest of the test code. We cannot bring them along with the callback to where it is run, so it would waste execution time and memory to bundle its dependencies in the original preprocessing. The dependencies are only bundled with the code that needs them when we preprocess the callback itself.

Additionally, we tried a solution previously that allowed use of `require` and `import`, but found that it hurt performance not only for spec files using them within the `cy.origin()` callback, but even for spec files that did not use them. That solution was also preprocessor-dependent and only worked for the webpack preprocessor. Using `Cypress.require` is preprocessor-agnostic.

## History

| Version | Changes |
| --- | --- |
| [12.6.0](/llm/markdown/app/references/changelog.md#12-6-0) | `Cypress.require` added and support for using CommonJS `require()` and ES module `import()` removed |
| [10.11.0](/llm/markdown/app/references/changelog.md#10-11-0) | `Cypress.require` removed in favor of CommonJS `require()` and ES module `import()` |
| [10.7.0](/llm/markdown/app/references/changelog.md#10-7-0) | `Cypress.require` added |

## See also

*   [`cy.origin()`](/llm/markdown/api/commands/origin.md)