在同构反应应用程序中,我有 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 使用这种方法,但我不知道这个配置在哪里定义。
动机
package.json
是进行这种拆分的良好语义点。- 客户端包仅包含
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 许可协议
此处的行为已标准化: https ://github.com/defunctzombie/package-browser-field-spec
尽管此规范不是官方规范,但许多 Javascript 打包器都遵循它,包括 Webpack、Browserify 和 React Native 打包器。浏览器字段不仅允许您更改模块入口点,还可以替换或忽略模块中的单个文件。这是相当强大的。
由于 Webpack 默认捆绑 web 代码,如果你想将 Webpack 用于你的服务器构建,你需要手动禁用浏览器字段。您可以使用
target
配置选项来做到这一点: https ://webpack.js.org/concepts/targets/