节点和浏览器在 package.json 中的不同主要入口点

新手上路,请多包涵

在同构反应应用程序中,我有 myModule 它在节点和浏览器环境中的行为应该不同。我想在 package.json 中为 myModule 配置这个分割点:

package.json

 {
  "private": true,
  "name": "myModule",
  "main": "./myModule.server.js",
  "browser": "./myModule.client.js"
}

file structure

 ├── myModule
│   ├── myModule.client.js
│   ├── myModule.server.js
│   └── package.json
│
├── browser.js
└── server.js

因此,当我在 节点 中使用 myModule 时,我应该只得到 myModule.server.js

server.js

 import myModule from './myModule';
myModule(); // invoke myModule.server.js

浏览器 端应该仅使用 myModule.client.js 构建捆绑包

browser.js

 import myModule from './myModule';
myModule(); // invoke myModule.client.js

react-starter-kit 使用这种方法,但我不知道这个配置在哪里定义。


动机

  1. package.json 是进行这种拆分的良好语义点。
  2. 客户端包仅包含 myModule.client.js

已知解决方案 - 对我来说不是答案

你可以有这种文件结构:

 ├── myModule
│    ├── myModule.client.js
│    ├── myModule.server.js
│    └── index.js           <-- difference
│
├── browser.js
└── server.js

index.js 中:

 if (process.browser) { // this condition can be different but you get the point
    module.exports = require('./myModule.client');
} else {
    module.exports = require('./myModule.server');
}

这样做的主要问题是客户端包 包含大量沉重的 kB 后端代码


我的网络包配置

我包括我的 webpack.config.js 。奇怪的是,对于浏览器和节点,此配置始终指向 myModule.client.js

 const webpack = require('webpack');
var path = require('path');
var fs = require('fs');

const DEBUG = !process.argv.includes('--release');
const VERBOSE = !process.argv.includes('--verbose');
const AUTOPREFIXER_BROWSERS = [
    'Android 2.3',
    'Android >= 4',
    'Chrome >= 35',
    'Firefox >= 31',
    'Explorer >= 9',
    'iOS >= 7',
    'Opera >= 12',
    'Safari >= 7.1',
];

let nodeModules = {};
fs.readdirSync('node_modules')
    .filter(function(x) {
        return ['.bin'].indexOf(x) === -1 ;
    })
    .forEach(function(mod) {
        nodeModules[mod] = 'commonjs ' + mod;
    });

let loaders = [
    {
        exclude: /node_modules/,
        loader: 'babel'
    },
    {
        test: [/\.scss$/,/\.css$/],
        loaders: [
            'isomorphic-style-loader',
            `css-loader?${DEBUG ? 'sourceMap&' : 'minimize&'}modules&localIdentName=` +
            `${DEBUG ? '[name]_[local]_[hash:base64:3]' : '[hash:base64:4]'}`,
            'postcss-loader?parser=postcss-scss'
        ]
    },
    {
        test: /\.(png|jpg|jpeg|gif|svg|woff|woff2)$/,
        loader: 'url-loader',
        query: {
            name: DEBUG ? '[name].[ext]' : '[hash].[ext]',
            limit: 10000,
        },
    },
    {
        test: /\.(eot|ttf|wav|mp3)$/,
        loader: 'file-loader',
        query: {
            name: DEBUG ? '[name].[ext]' : '[hash].[ext]',
        },
    },
    {
        test: /\.json$/,
        loader: 'json-loader',
    },
];

const common = {
    module: {
        loaders
    },
    plugins: [
        new webpack.optimize.OccurenceOrderPlugin(),
    ],
    postcss: function plugins(bundler) {
        var plugins = [
            require('postcss-import')({ addDependencyTo: bundler }),
            require('precss')(),
            require('autoprefixer')({ browsers: AUTOPREFIXER_BROWSERS }),
        ];

        return plugins;
    },
    resolve: {
        root: path.resolve(__dirname, 'src'),
        extensions: ['', '.js', '.jsx', '.json']
    }
};

module.exports = [
    Object.assign({} , common, { // client
        entry: [
            'babel-polyfill',
            './src/client.js'
        ],
        output: {
            path: __dirname + '/public/',
            filename: 'bundle.js'
        },
        target: 'web',
        node: {
            fs: 'empty',
        },
        devtool: DEBUG ? 'cheap-module-eval-source-map' : false,
        plugins: [
            ...common.plugins,
            new webpack.DefinePlugin({'process.env.BROWSER': true }),
        ],
    }),
    Object.assign({} , common, { // server
        entry: [
            'babel-polyfill',
            './src/server.js'
        ],
        output: {
            path: __dirname + '',
            filename: 'server.js'
        },
        target: 'node',
        plugins: [
            ...common.plugins,
            new webpack.DefinePlugin({'process.env.BROWSER': false }),
        ],
        node: {
            console: false,
            global: false,
            process: false,
            Buffer: false,
            __filename: false,
            __dirname: false,
        },
        externals: nodeModules,

    })
];

原文由 Everettss 发布,翻译遵循 CC BY-SA 4.0 许可协议

阅读 204
1 个回答

此处的行为已标准化: https ://github.com/defunctzombie/package-browser-field-spec

尽管此规范不是官方规范,但许多 Javascript 打包器都遵循它,包括 Webpack、Browserify 和 React Native 打包器。浏览器字段不仅允许您更改模块入口点,还可以替换或忽略模块中的单个文件。这是相当强大的。

由于 Webpack 默认捆绑 web 代码,如果你想将 Webpack 用于你的服务器构建,你需要手动禁用浏览器字段。您可以使用 target 配置选项来做到这一点: https ://webpack.js.org/concepts/targets/

原文由 William Swanson 发布,翻译遵循 CC BY-SA 3.0 许可协议

推荐问题