Add testEnvironmentOptions to apply to jsdom options or node context. (#5003)

* Allow testEnvironmentOptions to be sent to jsdom options or node context.

* Update pull-request#5003.

* Fix integration_test show_config snapshot.

* available in Jest **22

* Add testEnvironmentOptions to integration_tests.

* Fix lint errors and environmentOptions.

* Fix more lint errors.

* Fix lint quoting, burned since all my other projects want double-quotes.

Author: kmashint

CHANGELOG.md

@@ -53,6 +53,8 @@
 
 ### Features
 
+* `[jest-config]` Add `testEnvironmentOptions` to apply to jsdom options or node context.
+  ([#5003](https://github.com/facebook/jest/pull/5003))
 * `[jest-jasmine2]` Update Timeout error message to `jest.timeout` and display
   current timeout value ([#4990](https://github.com/facebook/jest/pull/4990))
 * `[jest-runner]` Enable experimental detection of leaked contexts

docs/Configuration.md

@@ -726,6 +726,17 @@ class CustomEnvironment extends NodeEnvironment {
 }
 ```
 
+### `testEnvironmentOptions` [Object]
+
+##### available in Jest **22.0.0+**
+
+Default: `{}`
+
+Test environment options that will be passed to the `testEnvironment`.  The
+relevant options depend on the environment.  For example you can override
+options given to [jsdom](https://github.com/tmpvar/jsdom) such as
+`{userAgent: "Agent/007"}`.
+
 ### `testMatch` [array<string>]
 
 ##### available in Jest **19.0.0+**

integration_tests/__tests__/__snapshots__/show_config.test.js.snap

@@ -39,6 +39,7 @@ exports[`--showConfig outputs config info and exits 1`] = `
       \\"setupFiles\\": [],
       \\"snapshotSerializers\\": [],
       \\"testEnvironment\\": \\"jest-environment-jsdom\\",
+      \\"testEnvironmentOptions\\": {},
       \\"testLocationInResults\\": false,
       \\"testMatch\\": [
         \\"**/__tests__/**/*.js?(x)\\",

integration_tests/__tests__/config.test.js

@@ -59,3 +59,18 @@ test('config from argv is respected with sane config JSON', () => {
 
   expect(stdout).toMatch('"watchman": false');
 });
+
+test('works with jsdom testEnvironmentOptions config JSON', () => {
+  const result = runJest('environmentOptions', [
+    '--config=' +
+      JSON.stringify({
+        testEnvironmentOptions: {
+          userAgent: 'Agent/007',
+        },
+      }),
+  ]);
+  const stderr = result.stderr.toString();
+
+  expect(result.status).toBe(0);
+  expect(stderr).toMatch('found userAgent Agent/007');
+});

integration_tests/environmentOptions/__tests__/environmentOptions.test.js

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+'use strict';
+/*global window */
+
+test('found userAgent Agent/007', () => {
+  expect(window.navigator.userAgent).toBe('Agent/007');
+});

integration_tests/environmentOptions/package.json

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

packages/jest-config/src/defaults.js

@@ -56,6 +56,7 @@ export default ({
   runner: 'jest-runner',
   snapshotSerializers: [],
   testEnvironment: 'jest-environment-jsdom',
+  testEnvironmentOptions: {},
   testFailureExitCode: 1,
   testLocationInResults: false,
   testMatch: ['**/__tests__/**/*.js?(x)', '**/?(*.)(spec|test).js?(x)'],

packages/jest-config/src/index.js

@@ -146,6 +146,7 @@ const getConfigs = (
       skipNodeResolution: options.skipNodeResolution,
       snapshotSerializers: options.snapshotSerializers,
       testEnvironment: options.testEnvironment,
+      testEnvironmentOptions: options.testEnvironmentOptions,
       testLocationInResults: options.testLocationInResults,
       testMatch: options.testMatch,
       testPathIgnorePatterns: options.testPathIgnorePatterns,

packages/jest-config/src/normalize.js

@@ -480,6 +480,7 @@ export default function normalize(options: InitialOptions, argv: Argv) {
       case 'silent':
       case 'skipNodeResolution':
       case 'testEnvironment':
+      case 'testEnvironmentOptions':
       case 'testFailureExitCode':
       case 'testLocationInResults':
       case 'testNamePattern':

packages/jest-config/src/valid_config.js

@@ -77,6 +77,7 @@ export default ({
   skipNodeResolution: false,
   snapshotSerializers: ['my-serializer-module'],
   testEnvironment: 'jest-environment-jsdom',
+  testEnvironmentOptions: {},
   testFailureExitCode: 1,
   testLocationInResults: false,
   testMatch: ['**/__tests__/**/*.js?(x)', '**/?(*.)(spec|test).js?(x)'],