cypress 3.3.0 → 3.3.1

package/lib/errors.js

@@ -5,9 +5,9 @@ var _templateObject = _taggedTemplateLiteral(['\n    Search for an existing issu
     _templateObject3 = _taggedTemplateLiteral(['\n\n    Reasons this may happen:\n\n    - node was installed as \'root\' or with \'sudo\'\n    - the cypress npm package as \'root\' or with \'sudo\'\n\n    Please check that you have the appropriate user permissions.\n  '], ['\\n\n    Reasons this may happen:\n\n    - node was installed as \'root\' or with \'sudo\'\n    - the cypress npm package as \'root\' or with \'sudo\'\n\n    Please check that you have the appropriate user permissions.\n  ']),
     _templateObject4 = _taggedTemplateLiteral(['\n\n    We expected the binary to be installed here: ', '\n\n    Reasons it may be missing:\n\n    - You\'re caching \'node_modules\' but are not caching this path: ', '\n    - You ran \'npm install\' at an earlier build step but did not persist: ', '\n\n    Properly caching the binary will fix this error and avoid downloading and unzipping Cypress.\n\n    Alternatively, you can run \'cypress install\' to download the binary again.\n\n    ', '\n  '], ['\\n\n    We expected the binary to be installed here: ', '\n\n    Reasons it may be missing:\n\n    - You\'re caching \'node_modules\' but are not caching this path: ', '\n    - You ran \'npm install\' at an earlier build step but did not persist: ', '\n\n    Properly caching the binary will fix this error and avoid downloading and unzipping Cypress.\n\n    Alternatively, you can run \'cypress install\' to download the binary again.\n\n    ', '\n  ']),
     _templateObject5 = _taggedTemplateLiteral(['\n    There was a problem spawning Xvfb.\n\n    This is likely a problem with your system, permissions, or installation of Xvfb.\n    '], ['\n    There was a problem spawning Xvfb.\n\n    This is likely a problem with your system, permissions, or installation of Xvfb.\n    ']),
-    _templateObject6 = _taggedTemplateLiteral(['\n    Install XVFB and run Cypress again.\n\n    Read our documentation on dependencies for more information:\n\n      ', '\n\n    If you are using Docker, we provide containers with all required dependencies installed.\n    '], ['\n    Install XVFB and run Cypress again.\n\n    Read our documentation on dependencies for more information:\n\n      ', '\n\n    If you are using Docker, we provide containers with all required dependencies installed.\n    ']),
+    _templateObject6 = _taggedTemplateLiteral(['\n    Install Xvfb and run Cypress again.\n\n    Read our documentation on dependencies for more information:\n\n      ', '\n\n    If you are using Docker, we provide containers with all required dependencies installed.\n    '], ['\n    Install Xvfb and run Cypress again.\n\n    Read our documentation on dependencies for more information:\n\n      ', '\n\n    If you are using Docker, we provide containers with all required dependencies installed.\n    ']),
     _templateObject7 = _taggedTemplateLiteral(['\n    This command failed with the following output:\n\n    ', '\n\n    '], ['\n    This command failed with the following output:\n\n    ', '\n\n    ']),
-    _templateObject8 = _taggedTemplateLiteral(['\n      Cypress failed to start after spawning a new XVFB server.\n\n      The error logs we received were:\n\n      ', '\n\n      ', '\n\n      ', '\n\n      This is usually caused by a missing library or dependency.\n\n      The error above should indicate which dependency is missing.\n\n        ', '\n\n      If you are using Docker, we provide containers with all required dependencies installed.\n    '], ['\n      Cypress failed to start after spawning a new XVFB server.\n\n      The error logs we received were:\n\n      ', '\n\n      ', '\n\n      ', '\n\n      This is usually caused by a missing library or dependency.\n\n      The error above should indicate which dependency is missing.\n\n        ', '\n\n      If you are using Docker, we provide containers with all required dependencies installed.\n    ']),
+    _templateObject8 = _taggedTemplateLiteral(['\n      Cypress failed to start after spawning a new Xvfb server.\n\n      The error logs we received were:\n\n      ', '\n\n      ', '\n\n      ', '\n\n      This is usually caused by a missing library or dependency.\n\n      The error above should indicate which dependency is missing.\n\n        ', '\n\n      If you are using Docker, we provide containers with all required dependencies installed.\n    '], ['\n      Cypress failed to start after spawning a new Xvfb server.\n\n      The error logs we received were:\n\n      ', '\n\n      ', '\n\n      ', '\n\n      This is usually caused by a missing library or dependency.\n\n      The error above should indicate which dependency is missing.\n\n        ', '\n\n      If you are using Docker, we provide containers with all required dependencies installed.\n    ']),
     _templateObject9 = _taggedTemplateLiteral(['\n    This is usually caused by a missing library or dependency.\n\n    The error below should indicate which dependency is missing.\n\n      ', '\n\n    If you are using Docker, we provide containers with all required dependencies installed.\n  '], ['\n    This is usually caused by a missing library or dependency.\n\n    The error below should indicate which dependency is missing.\n\n      ', '\n\n    If you are using Docker, we provide containers with all required dependencies installed.\n  ']),
     _templateObject10 = _taggedTemplateLiteral(['\n    See discussion and possible solutions at\n    ', '\n  '], ['\n    See discussion and possible solutions at\n    ', '\n  ']),
     _templateObject11 = _taggedTemplateLiteral(['\n    Please search Cypress documentation for possible solutions:\n\n      ', '\n\n    Check if there is a GitHub issue describing this crash:\n\n      ', '\n\n    Consider opening a new issue.\n  '], ['\n    Please search Cypress documentation for possible solutions:\n\n      ', '\n\n    Check if there is a GitHub issue describing this crash:\n\n      ', '\n\n    Consider opening a new issue.\n  ']),
@@ -76,12 +76,12 @@ var notInstalledCI = function notInstalledCI(executable) {
 };
 
 var nonZeroExitCodeXvfb = {
-  description: 'XVFB exited with a non zero exit code.',
+  description: 'Xvfb exited with a non zero exit code.',
   solution: stripIndent(_templateObject5)
 };
 
 var missingXvfb = {
-  description: 'Your system is missing the dependency: XVFB',
+  description: 'Your system is missing the dependency: Xvfb',
   solution: stripIndent(_templateObject6, chalk.blue(requiredDependenciesUrl))
 };
 

package/lib/exec/spawn.js

@@ -50,7 +50,7 @@ function getStdio(needsXvfb) {
   if (needsStderrPiped(needsXvfb)) {
     // returning pipe here so we can massage stderr
     // and remove garbage from Xlib and libuv
-    // due to starting the XVFB process on linux
+    // due to starting the Xvfb process on linux
     return ['inherit', 'inherit', 'pipe'];
   }
 
@@ -68,7 +68,7 @@ module.exports = {
       executable = path.resolve(util.getEnv('CYPRESS_RUN_BINARY'));
     }
 
-    debug('needs to start own XVFB?', needsXvfb);
+    debug('needs to start own Xvfb?', needsXvfb);
 
     // always push cwd into the args
     args = [].concat(args, '--cwd', process.cwd());
@@ -224,7 +224,7 @@ module.exports = {
 
     // if we are on linux and there's already a DISPLAY
     // set, then we may need to rerun cypress after
-    // spawning our own XVFB server
+    // spawning our own Xvfb server
     var linuxWithDisplayEnv = util.isPossibleLinuxWithIncorrectDisplay();
 
     return userFriendlySpawn(linuxWithDisplayEnv);

package/lib/exec/xvfb.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var _templateObject = _taggedTemplateLiteral(['\n        DISPLAY environment variable is set to ', ' on Linux\n        Assuming this DISPLAY points at working X11 server,\n        Cypress will not spawn own XVFB\n\n        NOTE: if the X11 server is NOT working, Cypress will exit without explanation,\n          see ', '\n        Solution: Unset the DISPLAY variable and try again:\n          DISPLAY= npx cypress run ...\n      '], ['\n        DISPLAY environment variable is set to ', ' on Linux\n        Assuming this DISPLAY points at working X11 server,\n        Cypress will not spawn own XVFB\n\n        NOTE: if the X11 server is NOT working, Cypress will exit without explanation,\n          see ', '\n        Solution: Unset the DISPLAY variable and try again:\n          DISPLAY= npx cypress run ...\n      ']);
+var _templateObject = _taggedTemplateLiteral(['\n        DISPLAY environment variable is set to ', ' on Linux\n        Assuming this DISPLAY points at working X11 server,\n        Cypress will not spawn own Xvfb\n\n        NOTE: if the X11 server is NOT working, Cypress will exit without explanation,\n          see ', '\n        Solution: Unset the DISPLAY variable and try again:\n          DISPLAY= npx cypress run ...\n      '], ['\n        DISPLAY environment variable is set to ', ' on Linux\n        Assuming this DISPLAY points at working X11 server,\n        Cypress will not spawn own Xvfb\n\n        NOTE: if the X11 server is NOT working, Cypress will exit without explanation,\n          see ', '\n        Solution: Unset the DISPLAY variable and try again:\n          DISPLAY= npx cypress run ...\n      ']);
 
 function _taggedTemplateLiteral(strings, raw) { return Object.freeze(Object.defineProperties(strings, { raw: { value: Object.freeze(raw) } })); }
 
@@ -35,7 +35,7 @@ module.exports = {
   _xvfb: xvfb, // expose for testing
 
   start: function start() {
-    debug('Starting XVFB');
+    debug('Starting Xvfb');
 
     return xvfb.startAsync().return(null).catch({ nonZeroExitCode: true }, throwFormErrorText(errors.nonZeroExitCodeXvfb)).catch(function (err) {
       if (err.known) {
@@ -46,7 +46,7 @@ module.exports = {
     });
   },
   stop: function stop() {
-    debug('Stopping XVFB');
+    debug('Stopping Xvfb');
 
     return xvfb.stopAsync().return(null).catch(function () {
       // noop
@@ -68,7 +68,7 @@ module.exports = {
     }
 
     debug('undefined DISPLAY environment variable');
-    debug('Cypress will spawn its own XVFB');
+    debug('Cypress will spawn its own Xvfb');
 
     return true;
   },

package/lib/tasks/verify.js

@@ -78,7 +78,7 @@ var runSmokeTest = function runSmokeTest(binaryDir, options) {
 
   var needsXvfb = xvfb.isNeeded();
 
-  debug('needs XVFB?', needsXvfb);
+  debug('needs Xvfb?', needsXvfb);
 
   /**
    * Spawn Cypress running smoke test to check if all operating system
@@ -88,8 +88,6 @@ var runSmokeTest = function runSmokeTest(binaryDir, options) {
     var random = _.random(0, 1000);
     var args = ['--smoke-test', '--ping=' + random];
 
-    process.env.ELECTRON_ENABLE_LOGGING = true;
-
     if (options.dev) {
       executable = 'node';
       args.unshift(path.resolve(__dirname, '..', '..', '..', 'scripts', 'start.js'));
@@ -101,7 +99,16 @@ var runSmokeTest = function runSmokeTest(binaryDir, options) {
     debug('using Cypress executable %s', executable);
     debug('smoke test command:', smokeTestCommand);
 
-    return Promise.resolve(util.exec(executable, args, { timeout: options.smokeTestTimeout })).catch(onSmokeTestError(smokeTestCommand, linuxWithDisplayEnv)).then(function (result) {
+    var env = _.extend({}, process.env, {
+      ELECTRON_ENABLE_LOGGING: true
+    });
+
+    var stdioOptions = _.extend({}, {
+      env: env,
+      timeout: options.smokeTestTimeout
+    });
+
+    return Promise.resolve(util.exec(executable, args, stdioOptions)).catch(onSmokeTestError(smokeTestCommand, linuxWithDisplayEnv)).then(function (result) {
       // TODO: when execa > 1.1 is released
       // change this to `result.all` for both stderr and stdout
       var smokeTestReturned = result.stdout;
@@ -136,7 +143,7 @@ var runSmokeTest = function runSmokeTest(binaryDir, options) {
 
   // if we are on linux and there's already a DISPLAY
   // set, then we may need to rerun cypress after
-  // spawning our own XVFB server
+  // spawning our own Xvfb server
   var linuxWithDisplayEnv = util.isPossibleLinuxWithIncorrectDisplay();
 
   return userFriendlySpawn(linuxWithDisplayEnv);

package/lib/util.js

@@ -49,7 +49,7 @@ function normalizeModuleOptions() {
 
 /**
  * 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
+ * stuff on Linux (like Xvfb) and it helps to has readable code
  */
 var isLinux = function isLinux() {
   return os.platform() === 'linux';
@@ -71,7 +71,7 @@ var isPossibleLinuxWithIncorrectDisplay = function isPossibleLinuxWithIncorrectD
 };
 
 var logBrokenGtkDisplayWarning = function logBrokenGtkDisplayWarning() {
-  debug('Cypress exited due to a broken gtk display because of a potential invalid DISPLAY env... retrying after starting XVFB');
+  debug('Cypress exited due to a broken gtk display because of a potential invalid DISPLAY env... retrying after starting Xvfb');
 
   // if we get this error, we are on Linux and DISPLAY is set
   logger.warn(stripIndent(_templateObject, logSymbols.warning, process.env.DISPLAY));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cypress",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "main": "index.js",
   "bin": {
     "cypress": "bin/cypress"

package/types/index.d.ts

@@ -3593,6 +3593,22 @@ declare namespace Cypress {
      * @see https://on.cypress.io/assertions
      */
     (chainer: 'contain', value: string): Chainable<Subject>
+    /**
+     * Assert that at least one element of the selection is focused.
+     * @example
+     *    cy.get('#result').should('have.focus')
+     *    cy.get('#result').should('be.focused')
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'have.focus'): Chainable<Subject>
+    /**
+     * Assert that at least one element of the selection is focused.
+     * @example
+     *    cy.get('#result').should('be.focused')
+     *    cy.get('#result').should('have.focus')
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.focused'): Chainable<Subject>
     /**
      * Assert that the selection is not empty. Note that this overrides the built-in chai assertion. If the object asserted against is not a jQuery object, the original implementation will be called.
      * @example
@@ -3749,6 +3765,22 @@ declare namespace Cypress {
      * @see https://on.cypress.io/assertions
      */
     (chainer: 'not.be.visible'): Chainable<Subject>
+    /**
+     * Assert that no element of the selection is focused.
+     * @example
+     *    cy.get('#result').should('not.have.focus')
+     *    cy.get('#result').should('not.be.focused')
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.have.focus'): Chainable<Subject>
+    /**
+     * Assert that no element of the selection is focused.
+     * @example
+     *    cy.get('#result').should('not.be.focused')
+     *    cy.get('#result').should('not.have.focus')
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.focused'): Chainable<Subject>
     /**
      * Assert that the selection does not contain the given text, using `:contains()`. If the object asserted against is not a jQuery object, or if `contain` is not called as a function, the original implementation will be called.
      * @example