mirror of https://github.com/cypress-io/cypress.git synced 2026-01-25 00:19:22 -06:00

Files

Jennifer Shehane a7dfda9865 Show warning when binary is run directly (outside npm module) (#4701 )

* commit previous changes made by @bahmutov for #1573

* Pass '--run-from-cli' flag through ping test in order to prevent warning from printing

* woops, require 'argsUntil'

* 'headed' was changed to 'interactiveMode'

* fix duplicate misspelled require

* tighten up args utils and cleanup decaf garbage

* cleanup errors.log to take a cb and conditionally be async

* remove extraneous --run-from-cli argument, consolidate to use --cli

- update tests

* fixes tests, ensure that record.createRun() always returns a promise

* refactor tests to handle new errors.logException interface

* make logException always return a promise, cleanup interface, add test

* fix linting errors


Co-authored-by: Brian Mann <brian.mann86@gmail.com>

2019-07-29 07:33:33 -04:00

__snapshots__

[internal] use webpack for builds (#4103 )

2019-07-18 12:11:27 -04:00

config

…

lib

Show warning when binary is run directly (outside npm module) (#4701 )

2019-07-29 07:33:33 -04:00

test

Show warning when binary is run directly (outside npm module) (#4701 )

2019-07-29 07:33:33 -04:00

.gitignore

End proxied responses for 1xx, 204, 304 with no body, fix bug where cy server could be proxied (#4358 )

2019-06-19 00:19:30 -04:00

index.js

Fix DNS lookup for 'localhost' when offline on Windows (#4774 )

2019-07-22 12:57:17 -04:00

package.json

fix(deps): update dependency duplexify to version 4.1.1 🌟 (#4853 )

2019-07-29 15:44:57 +06:30

README.md

…

repl.js

[internal] Lint typescript, json, new eslint rules (#4449 )

2019-07-12 13:59:44 -04:00

tsconfig.json

Improved proxy support (#3531 )

2019-03-31 23:39:10 -04:00

README.md

Server

The server is the heart of the Cypress application. All of this code represents the node process running behind the browser application. This node process is responsible for:

Proxying every byte coming in and out of the browser
Performing and normalizing automation tasks for each browser
Coordinating and synchronizing state with the desktop-gui and driver packages
Performing node specific tasks on behalf of the driver
Instantiating and orchestrating nearly every other layer and package
Spinning up various static file and http servers
Communicating with our external API's
Recording videos of run
Managing mocha reporters
Managing 3rd party plugins

The driver and the server are the two most complex packages of Cypress.

Installing

The server's dependencies can be installed with:

cd packages/server
npm install

Developing

To run Cypress:

npm start ## boots the entire Cypress application

Since the server controls nearly every aspect of Cypress, after making changes you'll need to manually restart Cypress.

Since this is slow, it's better to drive your development with tests.

Testing

npm run test-unit executes unit tests in test/unit
npm run test-integration executes integration tests in test/integration
npm run test-e2e executes the large (slow) end to end tests in test/e2e

Each of these tasks can run in "watch" mode by appending -watch to the task:

npm run test-unit-watch

Because of the large number of dependencies of the server, it's much more performant to run a single individual test.

## runs only this one test file
npm run test ./test/unit/api_spec.coffee

## works for integration tests too
npm run test ./test/integration/server_spec.coffee

You can also run a single test in watch mode.

## runs and watches only this one test file
npm run test-watch ./test/unit/api_spec.coffee

To run an individual e2e test:

## runs tests that match "base_url"
npm run test-e2e -- --spec base_url

To update snapshots, see snap-shot-it instructions: https://github.com/bahmutov/snap-shot-it#advanced-use