cypress 9.4.0 → 9.4.1

package/README.md

@@ -1,25 +1,25 @@
-# Cypress
-
-Fast, easy and reliable testing for anything that runs in a browser.
-
-## What is this?
-
-[Cypress](https://www.cypress.io/) comes packaged as an `npm` module, which is all you need to get started testing.
-
-After installing you'll be able to:
-
-- Open Cypress from the CLI
-- Run Cypress from the CLI
-- `require` Cypress as a module
-
-## Install
-
-Please check our [system requirements](https://on.cypress.io/installing-cypress).
-
-```sh
-npm install --save-dev cypress
-```
-
-## Documentation
-
-Please [visit our documentation](https://on.cypress.io/cli) for a full list of commands and examples.
+# Cypress
+
+Fast, easy and reliable testing for anything that runs in a browser.
+
+## What is this?
+
+[Cypress](https://www.cypress.io/) comes packaged as an `npm` module, which is all you need to get started testing.
+
+After installing you'll be able to:
+
+- Open Cypress from the CLI
+- Run Cypress from the CLI
+- `require` Cypress as a module
+
+## Install
+
+Please check our [system requirements](https://on.cypress.io/installing-cypress).
+
+```sh
+npm install --save-dev cypress
+```
+
+## Documentation
+
+Please [visit our documentation](https://on.cypress.io/cli) for a full list of commands and examples.

package/bin/cypress

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-
-require('../lib/cli').init()
+#!/usr/bin/env node
+
+require('../lib/cli').init()

package/lib/cli.js

@@ -223,12 +223,12 @@ const createProgram = () => {
 const addCypressRunCommand = program => {
   return program.command('run').usage('[options]').description('Runs Cypress tests from the CLI without the GUI').option('-b, --browser <browser-name-or-path>', text('browserRunMode')).option('--ci-build-id <id>', text('ciBuildId')).option('-c, --config <config>', text('config')).option('-C, --config-file <config-file>', text('configFile')).option('-e, --env <env>', text('env')).option('--group <name>', text('group')).option('-k, --key <record-key>', text('key')).option('--headed', text('headed')).option('--headless', text('headless')).option('--no-exit', text('exit')).option('--parallel', text('parallel')).option('-p, --port <port>', text('port')).option('-P, --project <project-path>', text('project')).option('-q, --quiet', text('quiet')).option('--record [bool]', text('record'), coerceFalse).option('-r, --reporter <reporter>', text('reporter')).option('-o, --reporter-options <reporter-options>', text('reporterOptions')).option('-s, --spec <spec>', text('spec')).option('-t, --tag <tag>', text('tag')).option('--dev', text('dev'), coerceFalse);
 };
-/**
- * Casts known command line options for "cypress run" to their intended type.
- * For example if the user passes "--port 5005" the ".port" property should be
- * a number 5005 and not a string "5005".
- *
- * Returns a clone of the original object.
+/**
+ * Casts known command line options for "cypress run" to their intended type.
+ * For example if the user passes "--port 5005" the ".port" property should be
+ * a number 5005 and not a string "5005".
+ *
+ * Returns a clone of the original object.
  */
 
 
@@ -251,12 +251,12 @@ const castCypressRunOptions = opts => {
 };
 
 module.exports = {
-  /**
-   * Parses `cypress run` command line option array into an object
-   * with options that you can feed into a `cypress.run()` module API call.
-   * @example
-   *  const options = parseRunCommand(['cypress', 'run', '--browser', 'chrome'])
-   *  // options is {browser: 'chrome'}
+  /**
+   * Parses `cypress run` command line option array into an object
+   * with options that you can feed into a `cypress.run()` module API call.
+   * @example
+   *  const options = parseRunCommand(['cypress', 'run', '--browser', 'chrome'])
+   *  // options is {browser: 'chrome'}
    */
   parseRunCommand(args) {
     return new Promise((resolve, reject) => {
@@ -284,8 +284,8 @@ module.exports = {
     });
   },
 
-  /**
-   * Parses the command line and kicks off Cypress process.
+  /**
+   * Parses the command line and kicks off Cypress process.
    */
   init(args) {
     if (!args) {

package/lib/cypress.js

@@ -16,18 +16,18 @@ const util = require('./util');
 const cli = require('./cli');
 
 const cypressModuleApi = {
-  /**
-   * Opens Cypress GUI
-   * @see https://on.cypress.io/module-api#cypress-open
+  /**
+   * Opens Cypress GUI
+   * @see https://on.cypress.io/module-api#cypress-open
    */
   open(options = {}) {
     options = util.normalizeModuleOptions(options);
     return open.start(options);
   },
 
-  /**
-   * Runs Cypress tests in the current project
-   * @see https://on.cypress.io/module-api#cypress-run
+  /**
+   * Runs Cypress tests in the current project
+   * @see https://on.cypress.io/module-api#cypress-run
    */
   run(options = {}) {
     if (!run.isValidProject(options.project)) {
@@ -56,15 +56,15 @@ const cypressModuleApi = {
   },
 
   cli: {
-    /**
-     * Parses CLI arguments into an object that you can pass to "cypress.run"
-     * @example
-     *  const cypress = require('cypress')
-     *  const cli = ['cypress', 'run', '--browser', 'firefox']
-     *  const options = await cypress.cli.parseRunArguments(cli)
-     *  // options is {browser: 'firefox'}
-     *  await cypress.run(options)
-     * @see https://on.cypress.io/module-api
+    /**
+     * Parses CLI arguments into an object that you can pass to "cypress.run"
+     * @example
+     *  const cypress = require('cypress')
+     *  const cli = ['cypress', 'run', '--browser', 'firefox']
+     *  const options = await cypress.cli.parseRunArguments(cli)
+     *  // options is {browser: 'firefox'}
+     *  await cypress.run(options)
+     * @see https://on.cypress.io/module-api
      */
     parseRunArguments(args) {
       return cli.parseRunCommand(args);
@@ -72,18 +72,18 @@ const cypressModuleApi = {
 
   },
 
-  /**
-   * Provides automatic code completion for configuration in many popular code editors.
-   * While it's not strictly necessary for Cypress to parse your configuration, we
-   * recommend wrapping your config object with `defineConfig()`
-   * @example
-   * module.exports = defineConfig({
-   *   viewportWith: 400
-   * })
-   *
-   * @see ../types/cypress-npm-api.d.ts
-   * @param {Cypress.ConfigOptions} config
-   * @returns {Cypress.ConfigOptions} the configuration passed in parameter
+  /**
+   * Provides automatic code completion for configuration in many popular code editors.
+   * While it's not strictly necessary for Cypress to parse your configuration, we
+   * recommend wrapping your config object with `defineConfig()`
+   * @example
+   * module.exports = defineConfig({
+   *   viewportWith: 400
+   * })
+   *
+   * @see ../types/cypress-npm-api.d.ts
+   * @param {Cypress.ConfigOptions} config
+   * @returns {Cypress.ConfigOptions} the configuration passed in parameter
    */
   defineConfig(config) {
     return config;

package/lib/errors.js

@@ -208,12 +208,12 @@ const invalidTestingType = {
   description: 'Invalid testingType',
   solution: `Please provide a valid testingType. Valid test types are ${chalk.cyan('\'e2e\'')} and ${chalk.cyan('\'component\'')}.`
 };
-/**
- * This error happens when CLI detects that the child Test Runner process
- * was killed with a signal, like SIGBUS
- * @see https://github.com/cypress-io/cypress/issues/5808
- * @param {'close'|'event'} eventName Child close event name
- * @param {string} signal Signal that closed the child process, like "SIGBUS"
+/**
+ * This error happens when CLI detects that the child Test Runner process
+ * was killed with a signal, like SIGBUS
+ * @see https://github.com/cypress-io/cypress/issues/5808
+ * @param {'close'|'event'} eventName Child close event name
+ * @param {string} signal Signal that closed the child process, like "SIGBUS"
 */
 
 const childProcessKilled = (eventName, signal) => {
@@ -240,17 +240,17 @@ function addPlatformInformation(info) {
     };
   });
 }
-/**
- * Given an error object (see the errors above), forms error message text with details,
- * then resolves with Error instance you can throw or reject with.
- * @param {object} errorObject
- * @returns {Promise<Error>} resolves with an Error
- * @example
-  ```js
-  // inside a Promise with "resolve" and "reject"
-  const errorObject = childProcessKilled('exit', 'SIGKILL')
-  return getError(errorObject).then(reject)
-  ```
+/**
+ * Given an error object (see the errors above), forms error message text with details,
+ * then resolves with Error instance you can throw or reject with.
+ * @param {object} errorObject
+ * @returns {Promise<Error>} resolves with an Error
+ * @example
+  ```js
+  // inside a Promise with "resolve" and "reject"
+  const errorObject = childProcessKilled('exit', 'SIGKILL')
+  return getError(errorObject).then(reject)
+  ```
  */
 
 
@@ -261,9 +261,9 @@ function getError(errorObject) {
     return err;
   });
 }
-/**
- * Forms nice error message with error and platform information,
- * and if possible a way to solve it. Resolves with a string.
+/**
+ * Forms nice error message with error and platform information,
+ * and if possible a way to solve it. Resolves with a string.
  */
 
 
@@ -343,11 +343,11 @@ const throwFormErrorText = info => {
     return formErrorText(info, msg, prevMessage).then(raise(info));
   };
 };
-/**
- * Forms full error message with error and OS details, prints to the error output
- * and then exits the process.
- * @param {ErrorInformation} info Error information {description, solution}
- * @example return exitWithError(errors.invalidCypressEnv)('foo')
+/**
+ * Forms full error message with error and OS details, prints to the error output
+ * and then exits the process.
+ * @param {ErrorInformation} info Error information {description, solution}
+ * @example return exitWithError(errors.invalidCypressEnv)('foo')
  */
 
 

package/lib/exec/run.js

@@ -19,11 +19,11 @@ const {
   processTestingType,
   throwInvalidOptionError
 } = require('./shared');
-/**
- * Typically a user passes a string path to the project.
- * But "cypress open" allows using `false` to open in global mode,
- * and the user can accidentally execute `cypress run --project false`
- * which should be invalid.
+/**
+ * Typically a user passes a string path to the project.
+ * But "cypress open" allows using `false` to open in global mode,
+ * and the user can accidentally execute `cypress run --project false`
+ * which should be invalid.
  */
 
 
@@ -38,14 +38,14 @@ const isValidProject = v => {
 
   return true;
 };
-/**
- * Maps options collected by the CLI
- * and forms list of CLI arguments to the server.
- *
- * Note: there is lightweight validation, with errors
- * thrown synchronously.
- *
- * @returns {string[]} list of CLI arguments
+/**
+ * Maps options collected by the CLI
+ * and forms list of CLI arguments to the server.
+ *
+ * Note: there is lightweight validation, with errors
+ * thrown synchronously.
+ *
+ * @returns {string[]} list of CLI arguments
  */
 
 

package/lib/exec/shared.js

@@ -3,10 +3,10 @@
 const {
   errors
 } = require('../errors');
-/**
- * Throws an error with "details" property from
- * "errors" object.
- * @param {Object} details - Error details
+/**
+ * Throws an error with "details" property from
+ * "errors" object.
+ * @param {Object} details - Error details
  */
 
 
@@ -21,10 +21,10 @@ const throwInvalidOptionError = details => {
   err.details = details;
   throw err;
 };
-/**
- * Selects exec args based on the configured `testingType`
- * @param {string} testingType The type of tests being executed
- * @returns {string[]} The array of new exec arguments
+/**
+ * Selects exec args based on the configured `testingType`
+ * @param {string} testingType The type of tests being executed
+ * @returns {string[]} The array of new exec arguments
  */
 
 

package/lib/tasks/cache.js

@@ -72,9 +72,9 @@ const prune = () => {
 const fileSizeInMB = size => {
   return `${(size / 1024 / 1024).toFixed(1)}MB`;
 };
-/**
- * Collects all cached versions, finds when each was used
- * and prints a table with results to the terminal
+/**
+ * Collects all cached versions, finds when each was used
+ * and prints a table with results to the terminal
  */
 
 

package/lib/tasks/download.js

@@ -104,9 +104,9 @@ const prettyDownloadErr = (err, version) => {
   debug(msg);
   return throwFormErrorText(errors.failedDownload)(msg);
 };
-/**
- * Checks checksum and file size for the given file. Allows both
- * values or just one of them to be checked.
+/**
+ * Checks checksum and file size for the given file. Allows both
+ * values or just one of them to be checked.
  */
 
 
@@ -300,10 +300,10 @@ const downloadFromUrl = ({
     });
   });
 };
-/**
- * Download Cypress.zip from external versionUrl to local file.
- * @param [string] version Could be "3.3.0" or full URL
- * @param [string] downloadDestination Local filename to save as
+/**
+ * Download Cypress.zip from external versionUrl to local file.
+ * @param [string] version Could be "3.3.0" or full URL
+ * @param [string] downloadDestination Local filename to save as
  */
 
 

package/lib/tasks/get-folder-size.js

@@ -7,14 +7,14 @@ const {
 } = require('path');
 
 const Bluebird = require('bluebird');
-/**
- * Get the size of a folder or a file.
- *
- * This function returns the actual file size of the folder (size), not the allocated space on disk (size on disk).
- * For more details between the difference, check this link:
- * https://www.howtogeek.com/180369/why-is-there-a-big-difference-between-size-and-size-on-disk/
- *
- * @param {string} path path to the file or the folder.
+/**
+ * Get the size of a folder or a file.
+ *
+ * This function returns the actual file size of the folder (size), not the allocated space on disk (size on disk).
+ * For more details between the difference, check this link:
+ * https://www.howtogeek.com/180369/why-is-there-a-big-difference-between-size-and-size-on-disk/
+ *
+ * @param {string} path path to the file or the folder.
  */
 
 

package/lib/tasks/state.js

@@ -70,8 +70,8 @@ const getBinaryPkgPath = binaryDir => {
       throw new Error(`Platform: "${platform}" is not supported.`);
   }
 };
-/**
- * Get path to binary directory
+/**
+ * Get path to binary directory
 */
 
 
@@ -82,9 +82,9 @@ const getBinaryDir = (version = util.pkgVersion()) => {
 const getVersionDir = (version = util.pkgVersion()) => {
   return path.join(getCacheDir(), version);
 };
-/**
- * When executing "npm postinstall" hook, the working directory is set to
- * "<current folder>/node_modules/cypress", which can be surprising when using relative paths.
+/**
+ * When executing "npm postinstall" hook, the working directory is set to
+ * "<current folder>/node_modules/cypress", which can be surprising when using relative paths.
  */
 
 
@@ -134,10 +134,10 @@ const parseRealPlatformBinaryFolderAsync = binaryPath => {
 const getDistDir = () => {
   return path.join(__dirname, '..', '..', 'dist');
 };
-/**
- * Returns full filename to the file that keeps the Test Runner verification state as JSON text.
- * Note: the binary state file will be stored one level up from the given binary folder.
- * @param {string} binaryDir - full path to the folder holding the binary.
+/**
+ * Returns full filename to the file that keeps the Test Runner verification state as JSON text.
+ * Note: the binary state file will be stored one level up from the given binary folder.
+ * @param {string} binaryDir - full path to the folder holding the binary.
  */
 
 
@@ -162,11 +162,11 @@ const getBinaryVerifiedAsync = binaryDir => {
 const clearBinaryStateAsync = binaryDir => {
   return fs.removeAsync(getBinaryStatePath(binaryDir));
 };
-/**
- * Writes the new binary status.
- * @param {boolean} verified The new test runner state after smoke test
- * @param {string} binaryDir Folder holding the binary
- * @returns {Promise<void>} returns a promise
+/**
+ * Writes the new binary status.
+ * @param {boolean} verified The new test runner state after smoke test
+ * @param {string} binaryDir Folder holding the binary
+ * @returns {Promise<void>} returns a promise
  */
 
 
@@ -183,9 +183,9 @@ const writeBinaryVerifiedAsync = (verified, binaryDir) => {
 const getPathToExecutable = binaryDir => {
   return path.join(binaryDir, getPlatformExecutable());
 };
-/**
- * Resolves with an object read from the binary app package.json file.
- * If the file does not exist resolves with null
+/**
+ * Resolves with an object read from the binary app package.json file.
+ * If the file does not exist resolves with null
  */
 
 

package/lib/tasks/verify.js

@@ -86,9 +86,9 @@ const runSmokeTest = (binaryDir, options) => {
 
   const needsXvfb = xvfb.isNeeded();
   debug('needs Xvfb?', needsXvfb);
-  /**
-   * Spawn Cypress running smoke test to check if all operating system
-   * dependencies are good.
+  /**
+   * Spawn Cypress running smoke test to check if all operating system
+   * dependencies are good.
    */
 
   const spawn = linuxWithDisplayEnv => {
@@ -329,14 +329,14 @@ const start = (options = {}) => {
 };
 
 const isLinuxLike = () => os.platform() !== 'win32';
-/**
- * Returns true if running on a system where Electron needs "--no-sandbox" flag.
- * @see https://crbug.com/638180
- *
- * On Debian we had problems running in sandbox even for non-root users.
- * @see https://github.com/cypress-io/cypress/issues/5434
- * Seems there is a lot of discussion around this issue among Electron users
- * @see https://github.com/electron/electron/issues/17972
+/**
+ * Returns true if running on a system where Electron needs "--no-sandbox" flag.
+ * @see https://crbug.com/638180
+ *
+ * On Debian we had problems running in sandbox even for non-root users.
+ * @see https://github.com/cypress-io/cypress/issues/5434
+ * Seems there is a lot of discussion around this issue among Electron users
+ * @see https://github.com/electron/electron/issues/17972
 */
 
 

package/lib/util.js

@@ -54,11 +54,11 @@ const pkg = require(path.join(__dirname, '..', 'package.json'));
 
 const issuesUrl = 'https://github.com/cypress-io/cypress/issues';
 const getosAsync = Promise.promisify(getos);
-/**
- * Returns SHA512 of a file
- *
- * Implementation lifted from https://github.com/sindresorhus/hasha
- * but without bringing that dependency (since hasha is Node v8+)
+/**
+ * Returns SHA512 of a file
+ *
+ * Implementation lifted from https://github.com/sindresorhus/hasha
+ * but without bringing that dependency (since hasha is Node v8+)
  */
 
 const getFileChecksum = filename => {
@@ -92,21 +92,21 @@ const stringify = val => {
 function normalizeModuleOptions(options = {}) {
   return _.mapValues(options, stringify);
 }
-/**
- * Returns true if the platform is Linux. We do a lot of different
- * stuff on Linux (like Xvfb) and it helps to has readable code
+/**
+ * Returns true if the platform is Linux. We do a lot of different
+ * stuff on Linux (like Xvfb) and it helps to has readable code
  */
 
 
 const isLinux = () => {
   return os.platform() === 'linux';
 };
-/**
-   * If the DISPLAY variable is set incorrectly, when trying to spawn
-   * Cypress executable we get an error like this:
-  ```
-  [1005:0509/184205.663837:WARNING:browser_main_loop.cc(258)] Gtk: cannot open display: 99
-  ```
+/**
+   * If the DISPLAY variable is set incorrectly, when trying to spawn
+   * Cypress executable we get an error like this:
+  ```
+  [1005:0509/184205.663837:WARNING:browser_main_loop.cc(258)] Gtk: cannot open display: 99
+  ```
    */
 
 
@@ -138,12 +138,12 @@ function stdoutLineMatches(expectedLine, stdout) {
   const lines = stdout.split('\n').map(val => val.trim());
   return lines.some(line => line === expectedLine);
 }
-/**
- * Confirms if given value is a valid CYPRESS_INTERNAL_ENV value. Undefined values
- * are valid, because the system can set the default one.
- *
- * @param {string} value
- * @example util.isValidCypressInternalEnvValue(process.env.CYPRESS_INTERNAL_ENV)
+/**
+ * Confirms if given value is a valid CYPRESS_INTERNAL_ENV value. Undefined values
+ * are valid, because the system can set the default one.
+ *
+ * @param {string} value
+ * @example util.isValidCypressInternalEnvValue(process.env.CYPRESS_INTERNAL_ENV)
  */
 
 
@@ -157,21 +157,21 @@ function isValidCypressInternalEnvValue(value) {
   const names = ['development', 'test', 'staging', 'production'];
   return _.includes(names, value);
 }
-/**
- * Confirms if given value is a non-production CYPRESS_INTERNAL_ENV value.
- * Undefined values are valid, because the system can set the default one.
- *
- * @param {string} value
- * @example util.isNonProductionCypressInternalEnvValue(process.env.CYPRESS_INTERNAL_ENV)
+/**
+ * Confirms if given value is a non-production CYPRESS_INTERNAL_ENV value.
+ * Undefined values are valid, because the system can set the default one.
+ *
+ * @param {string} value
+ * @example util.isNonProductionCypressInternalEnvValue(process.env.CYPRESS_INTERNAL_ENV)
  */
 
 
 function isNonProductionCypressInternalEnvValue(value) {
   return !_.isUndefined(value) && value !== 'production';
 }
-/**
- * Prints NODE_OPTIONS using debug() module, but only
- * if DEBUG=cypress... is set
+/**
+ * Prints NODE_OPTIONS using debug() module, but only
+ * if DEBUG=cypress... is set
  */
 
 
@@ -186,19 +186,19 @@ function printNodeOptions(log = debug) {
     log('NODE_OPTIONS is not set');
   }
 }
-/**
- * Removes double quote characters
- * from the start and end of the given string IF they are both present
- *
- * @param {string} str Input string
- * @returns {string} Trimmed string or the original string if there are no double quotes around it.
- * @example
-  ```
-  dequote('"foo"')
-  // returns string 'foo'
-  dequote('foo')
-  // returns string 'foo'
-  ```
+/**
+ * Removes double quote characters
+ * from the start and end of the given string IF they are both present
+ *
+ * @param {string} str Input string
+ * @returns {string} Trimmed string or the original string if there are no double quotes around it.
+ * @example
+  ```
+  dequote('"foo"')
+  // returns string 'foo'
+  dequote('foo')
+  // returns string 'foo'
+  ```
  */
 
 
@@ -234,9 +234,9 @@ const parseOpts = opts => {
   debug('parsed cli options %o', cleanOpts);
   return cleanOpts;
 };
-/**
- * Copy of packages/server/lib/browsers/utils.ts
- * because we need same functionality in CLI to show the path :(
+/**
+ * Copy of packages/server/lib/browsers/utils.ts
+ * because we need same functionality in CLI to show the path :(
  */
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cypress",
-  "version": "9.4.0",
+  "version": "9.4.1",
   "main": "index.js",
   "scripts": {
     "postinstall": "node index.js --exec install",