Add testNamePattern CLI argument (#1733)

* Add testNamePattern CLI argument

testNamePattern allows filtering tests by name with a regex

* Add -t as an alias for --testNamePattern

* Skip testNamePattern-test integration test on Windows

integration_tests/__tests__/testNamePattern-test.js

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree. An additional grant
+ * of patent rights can be found in the PATENTS file in the same directory.
+ */
+'use strict';
+
+const runJest = require('../runJest');
+const skipOnWindows = require('skipOnWindows');
+
+skipOnWindows.suite();
+
+test('testNamePattern', () => {
+  const result = runJest.json('testNamePattern', [
+    '--testNamePattern', 'should match',
+  ]);
+
+  expect(result.status).toBe(0);
+  expect(result.json.numTotalTests).toBe(4);
+  expect(result.json.numPassedTests).toBe(2);
+  expect(result.json.numFailedTests).toBe(0);
+});

integration_tests/testNamePattern/__tests__/testNamePattern-test.js

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree. An additional grant
+ * of patent rights can be found in the PATENTS file in the same directory.
+ */
+'use strict';
+
+test('should match 1', () => expect(1).toBe(1));
+test('should match 2', () => expect(1).toBe(1));
+test('should not match 1', () => expect(1).toBe(1));
+test('should not match 2', () => expect(1).toBe(1));

integration_tests/testNamePattern/package.json

@@ -0,0 +1,5 @@
+{
+  "jest": {
+    "testEnvironment": "node"
+  }
+}

packages/jest-cli/src/cli/args.js

@@ -91,6 +91,12 @@ const options = {
       'rare.',
     type: 'boolean',
   },
+  testNamePattern: {
+    alias: 't',
+    description:
+      'Run only tests with a name that matches the regex pattern.',
+    type: 'string',
+  },
   testPathPattern: {
     description:
       'A regexp pattern string that is matched against all tests ' +

packages/jest-config/src/setFromArgv.js

@@ -57,6 +57,10 @@ function setFromArgv(config, argv) {
     config.setupTestFrameworkScriptFile = argv.setupTestFrameworkScriptFile;
   }
 
+  if (argv.testNamePattern) {
+    config.testNamePattern = argv.testNamePattern;
+  }
+
   if (argv.updateSnapshot) {
     config.updateSnapshot = argv.updateSnapshot;
   }

packages/jest-jasmine2/src/index.js

@@ -133,6 +133,11 @@ function jasmine2(
     environment.fakeTimers.useFakeTimers();
   }
 
+  if (config.testNamePattern) {
+    const testNameRegex = new RegExp(config.testNamePattern);
+    env.specFilter = spec => testNameRegex.test(spec.getFullName());
+  }
+
   runtime.requireModule(testPath);
   env.execute();
   return reporter.getResults().then(results => {

types/Config.js

@@ -75,6 +75,7 @@ export type Config = BaseConfig & {
   setupTestFrameworkScriptFile: Path,
   silent: boolean,
   testcheckOptions: {},
+  testNamePattern: string,
   unmockedModulePathPatterns: Array<string>,
   updateSnapshot: boolean,
   usesBabelJest: boolean,