使用 webpack

    Jest 可以用于使用 webpack 来管理资源、 样式和编译的项目中。 webpack 确实 相比超过其他类似工具来说，展示出一些特有的优势，因为它直接与你的app整合，允许管理资源文件，如图像和字体，并带有可以将系统编译为JavaScript 语言和工具。

    我们通过以下常见的webpack 配置文件，将其转化为符合Jest使用的配置。

    webpack.config.js

    If you have JavaScript files that are transformed by Babel, you can by installing the plugin. Non-Babel JavaScript transformations can be handled with Jest’s transform config option. Non-Babel JavaScript transformations can be handled with Jest’s config option.

    接下来，让我们配置Jest，使其优雅地处理资源文件，如样式表和图像。 通常，这些文件在测试中无足轻重，因为我们可以安全地mock他们。 然而， 如果你使用CSS模块，那么最好是给你的类名查找模拟一个代理。

    package.json

    1. {
    3.   "jest": {
    5.     "moduleNameMapper": {
    7.       "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$": "<rootDir>/__mocks__/fileMock.js",
    9.       "\\.(css|less)$": "<rootDir>/__mocks__/styleMock.js"
    11.     }
    13.   }
    15. }

    所有mock文件本身:

    __mocks__/styleMock.js

    1. module.exports = {};

    __mocks__/fileMock.js

    1. module.exports = 'test-file-stub';

    然后在样式对象上，你的所有className查找都会原样返回 (如 styles.foobar === 'foobar') 这对React的Snapshot Testing是相当方便的. This is pretty handy for React .

    package.json (for CSS Modules)

    1. {
    3.   "jest": {
    5.     "moduleNameMapper": {
    7.       "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$": "<rootDir>/__mocks__/fileMock.js",
    9.       "\\.(css|less)$": "identity-obj-proxy"
    11.     }
    13.   }
    15. }

    如果 moduleNameMapper 不能满足你的需要，你就需要使用Jest的transform 来自定义对那些文件后缀应该如何转译。 例如，一个输出不带文件后缀的文件名 (such that require('logo. jpg'); returns 'logo') 应该这样写:

    fileTransformer.js

    1. const path = require('path');
    6. module.exports = {
    8.   process(src, filename, config, options) {
    10.     return 'module.exports = ' + JSON.stringify(path.basename(filename)) + ';';
    12.   },
    14. };

    package.json (for custom transformers and CSS Modules)

    1. {
    3.   "jest": {
    6.       "\\.(css|less)$": "identity-obj-proxy"
    8.     },
    12.       "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$": "<rootDir>/fileTransformer.js"
    14.     }
    16.   }
    18. }

    我们已经告知Jest忽略相关匹配的样式表或者图像文件，相反，导入我们的模拟文件。 你可以通过调整正规表达式来匹配webpack可以处理的文件类型。

    注：如果你bael-jest和额外的代码预处理器，你必须明确的定义babel-jest为你的Js代码的转换器，并且你需要映射所有.js文件到babel-jest模块。

    现在Jest知道如何处理我们的文件了， 接下来我们需要告诉它如何找到它们。 webpack的modulesDirectories, 和 extensions 选项都是和Jest的moduleDirectories 和 moduleFileExtensions选项类似的.

    1. {
    3.   "jest": {
    5.     "moduleFileExtensions": ["js", "jsx"],
    7.     "moduleDirectories": ["node_modules", "bower_components", "shared"],
    12.     "moduleNameMapper": {
    14.       "\\.(css|less)$": "<rootDir>/__mocks__/styleMock.js",
    16.       "\\.(gif|ttf|eot|svg)$": "<rootDir>/__mocks__/fileMock.js"
    18.     }
    20.   }
    22. }

    类似的，Webpack的resolve.root、 NODE_PATH环境变量都可以使用 modulePaths选项。

    package.json

    1. {
    3.   "jest": {
    5.     "modulePaths": ["/shared/vendor/modules"],
    7.     "moduleFileExtensions": ["js", "jsx"],
    9.     "moduleDirectories": ["node_modules", "bower_components", "shared"],
    11.     "moduleNameMapper": {
    13.       "\\.(css|less)$": "<rootDir>/__mocks__/styleMock.js",
    15.       "\\.(gif|ttf|eot|svg)$": "<rootDir>/__mocks__/fileMock.js"
    17.     }
    19.   }

    最后，我们关注一下Webpack的alias。 在这里，我们可以再次使用 moduleNameMapper。

    package.json

    1. {
    3.   "jest": {
    5.     "modulePaths": ["/shared/vendor/modules"],
    7.     "moduleFileExtensions": ["js", "jsx"],
    9.     "moduleDirectories": ["node_modules", "bower_components", "shared"],
    14.     "moduleNameMapper": {
    16.       "\\.(css|less)$": "<rootDir>/__mocks__/styleMock.js",
    18.       "\\.(gif|ttf|eot|svg)$": "<rootDir>/__mocks__/fileMock.js",
    23.       "^react(.*)$": "<rootDir>/vendor/react-master$1",
    25.       "^config$": "<rootDir>/configs/app-config.js"
    27.     }
    29.   }
    31. }

    配置完成。 webpack 是一个复杂和灵活的工具，所以你可能需要做一些调整，以符合你的特定应用的需要。 幸运的是对于大多数项目来说，使用Jest来处理webpack配置，应该会更灵活。

    使用 webpack 2

    webpack 2 提供原生支持ES模块。 然而，Jest在Node中使用时需要将ES模块转化为CommonJS模块。 因此，如果你使用webpack 2，你也可能希望能配置Babel在test环境能将ES模块转化为CommonJS模块。

    1. // .babelrc
    3. {
    5.   "presets": [["env", {"modules": false}]],
    10.   "plugins": ["syntax-dynamic-import"],
    15.   "env": {
    17.     "test": {
    19.       "plugins": ["dynamic-import-node"]
    21.     }
    23.   }
    24. }

    这里有关于在Webpack+React+Redux或Node的使用说明。