# @shelex/cypress-wait-network

> command for cypress to wait for network requests

Latest version **1.0.3** (published 2023-02-02) · MIT license · 0 weekly downloads

## Install

```sh
npm install @shelex/cypress-wait-network
pnpm add @shelex/cypress-wait-network
yarn add @shelex/cypress-wait-network
bun add @shelex/cypress-wait-network
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.3 |
| Published | 2023-02-02 |
| First published | 2021-10-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 9.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 9 |
| Author | Oleksandr Shevtsov |
| Maintainers | shelex |
| Keywords | cypress, network |

## Links

- npm: https://www.npmjs.com/package/@shelex/cypress-wait-network
- Repository: https://github.com/Shelex/cypress-wait-network
- Homepage: https://github.com/Shelex/cypress-wait-network#readme
- Issues: https://github.com/Shelex/cypress-wait-network/issues
- npm.io page: https://npm.io/package/@shelex/cypress-wait-network

## Alternatives

- [@snazzah/davey](https://npm.io/package/@snazzah/davey.md) — 1.5M weekly downloads
- [@vendure/testing](https://npm.io/package/@vendure/testing.md) — 8.3K weekly downloads
- [vue-simple-context-menu](https://npm.io/package/vue-simple-context-menu.md) — 6.6K weekly downloads
- [cypress-webpack-preprocessor-v5](https://npm.io/package/cypress-webpack-preprocessor-v5.md) — 2.1K weekly downloads
- [@backstage/plugin-catalog-backend-module-puppetdb](https://npm.io/package/@backstage/plugin-catalog-backend-module-puppetdb.md) — 1.3K weekly downloads

## Recent versions

- 1.0.3 (latest) — 2023-02-02
- 1.0.2 — 2021-10-19
- 1.0.1 — 2021-10-19
- 1.0.0 — 2021-10-19

## README

# @shelex/cypress-wait-network

[![SWUbanner](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://vshymanskyy.github.io/StandWithUkraine/)

# Deprecation notice

> Users have reported that in recent Cypress versions (v12+) requests are not being tracked.    
> I can confirm that is happening due to internal changes in Cypress behavior and some functionality that this plugin relies on was removed.  
> Thus I see no reason in re-developing it.  
> In case you consider migrating to Cypress v12+ please replace this plugin with [cypress-network-idle](https://github.com/bahmutov/cypress-network-idle) which utilizes intercept functionality instead of internals and should work fine and cover your use case.   


# Documentation

> Plugin that adds `cy.waitForNetwork` command that ensures background network requests are finished
> You can also enable automatic waiting before every cy.get by setting env var `waitForRequestsBeforeCyGet`

![Build][gh-image]
[![Downloads][downloads-image]][npm-url]
[![semantic-release][semantic-image]][semantic-url]  
[![version][version-image]][npm-url]
[![License][license-image]][license-url]

## Installation

-   download package:

    -   using yarn:

    ```bash
    yarn add -D @shelex/cypress-wait-network
    ```

    -   using npm:

    ```
    npm i -D @shelex/cypress-wait-network
    ```

-   register command in `cypress/support/index.js` file:

    -   with `import`:

    ```js
    import '@shelex/cypress-wait-network';
    ```

    -   or with `require`:

    ```js
    require('@shelex/cypress-wait-network');
    ```

-   for IntelliSense (autocompletion) support in your IDE

    -   add to your files:

    ```js
    /// <reference types="@shelex/cypress-wait-network" />
    ```

    -   or update your tsconfig.json `include` section:

    ```json
    "include": [
        "cypress",
        "@shelex/cypress-wait-network",
    ]
    ```

## Options

Command `cy.waitForNetwork` accepts an options object with such properties:

| property  | description                                            | default                                |
| :-------- | :----------------------------------------------------- | :------------------------------------- |
| `timeout` | timeout for requests loading (ms)                      | Cypress.config().responseTimeout (30s) |
| `idle`    | time to wait till network is recognized as idle (ms)\* | 1000 ms                                |

\* `idle` could be used to apply waiting strategy to your specific needs, as requests may be triggered after default `idle` is finished, usually caused by debouncing on front-end. By default command uses 1 second idle check which means in case there are no requests loading - it will wait minimum ~ 1s before finishing command, in case there are requests - it will reset timer until there would be at least 1 second when all responses are received, no other requests loading so we can treat network as idle.

## Configuration

Plugin is customizable via Cypress environment variables:

| env variable name            | description                                        | default |
| :--------------------------- | :------------------------------------------------- | :------ |
| `waitForRequestsBeforeCyGet` | run `waitForNetwork` command before every `cy.get` | false   |

This options could be passed:

-   via `cypress.json`

    ```json
    {
        "env": {
            "waitForRequestsBeforeCyGet": true
        }
    }
    ```

-   via `command line`:
    as [Cypress environment variables](https://docs.cypress.io/guides/guides/environment-variables#Option-4-env) are used please take into account that cli should have only one argument `--env` or `-e`, otherwise values will not be passed

        ```bash
        yarn cypress run --env waitForRequestsBeforeCyGet=true

        # for windows:
        yarn cypress run --env  "waitForRequestsBeforeCyGet=true","otherEnvVar=value"
        ```

## Credits

Inspired by Gleb Bahmutov <gleb.bahmutov@gmail.com> who made [cypress-network-idle](https://github.com/bahmutov/cypress-network-idle) plugin that has same purpose. Moreover command `cy.waitForNetworkIdle(2000)` from `cypress-network-idle` is quite same as `cy.waitForNetwork({ idle: 2000 })` from this package, first is based on interception and counters, this package just checks requests and responses from `cy.state`

## License

Copyright 2021-2023 Oleksandr Shevtsov <ovr.shevtsov@gmail.com>.  
This project is licensed under the MIT License.

[npm-url]: https://npmjs.com/package/@shelex/cypress-wait-network
[gh-image]: https://github.com/Shelex/cypress-wait-network/workflows/build/badge.svg?branch=master
[types-path]: ./index.d.ts
[semantic-image]: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
[semantic-url]: https://github.com/semantic-release/semantic-release
[license-image]: https://img.shields.io/npm/l/@shelex/cypress-wait-network
[license-url]: https://opensource.org/licenses/MIT
[version-image]: https://badgen.net/npm/v/@shelex/cypress-wait-network/latest
[downloads-image]: https://badgen.net/npm/dt/@shelex/cypress-wait-network

---
_Source: https://npm.io/package/@shelex/cypress-wait-network · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._